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GENERAL OPERATION 


At this point you should have completed the “System Set-Up Procedure”. If this 
is your first time through this Manual, you should have also performed “‘Initiali- 
zation,” “Diagnostic,” ‘Initialization’ (again), ‘System Generation,’ and 
“ONECOPY”’, in that order. 


Up until now, it was assumed that you were working exclusively with the 
distribution diskette and two spare diskettes. One of those diskettes became a 
duplicate of your distribution diskette, and the other became your BASIC disk. 
The purpose was to familiarize you with a minimum of HDOS and your system. 
Now that you have gained ‘‘hands-on”’ experience with the system, you are ready © 
to further explore the capabilities of HDOS. 


You will need to go back to the ‘‘System Set-Up Procedure” at a later time. All 
new diskettes must be initialized. You should also run the M option in TEST on 
all diskettes. This option tells you if there are any bad sectors on the diskette. If 
there are, you can (through INIT) instruct HDOS not to write any data there. 


You might also wish to create several system volumes, each with a different 
complement of resources such as BASIC (Extended BASIC), DBUG, EDIT, and 
ASM. You could also include INIT, TEST, ONECOPY, and SYSGEN on some of 
the system volumes. It would be best to accomplish this by first creating a 
“master” system volume by copying the entire contents of the distribution 
diskette. You can do this by means of ONECOPY. You should then store the 
distribution diskette in a safe place and use the master system volume instead; 
substituting it in any procedure which calls for the distribution diskette. 


This section will tell you how to use HDOS to create and manipulate files. Like 
“Theory of Operation,” its purpose is tutorial. You cannot successfully managea 
system such as HDOS without a basic understanding of its functions and 
capabilities. Perhaps you had only intended to use your diskette as a fast storage 
device for the BASIC interpreter and a collection of programs. You can do this 
with a minimal understanding of ‘‘General Operation,” but not very conve- 
niently or efficiently. The HDOS commands in this section will allow you to 
examine and manipulate your files directly. They give you power and flexibility 
similar to that of the system manager in a computation center, as well as the 
responsibility. The computer and disk drive are the main resources in your 
personal computation center; you are the system manager. 


NOTE: You can use two disk drives with HDOS. Some of the commands and 
capabilities described in this chapter will not be very useful if you only have one 
drive. However, HDOS will run on either configuration. 
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For details on how to use BASIC or other system resources such as DBUG or 
EDIT, refer to the appropriate sections in the Software Manuals. These programs 
will use some of the techniques explained here to allow you to write and run your 
own programs, using the diskette as a mass storage device. You may wish to go 
back and review the ‘“‘Theory of Operation” before proceeding with ‘‘General 
Operation.” 


File Names 


Each file must have a unique name so HDOS can store it and find it on the 
diskette(s). HDOS will not allow two files with identical names at the same time 
on the same diskette. The general format for file names is: 


DEV: FNAME. EXT 


Where DEV: is the device on which the file is stored, usually SY@: or SY1:; 
FNAME is the general name of the file; and .EXT is an ‘“‘extension’’ which allows 
HDOS to distinguish between files of the same general category. Remember you 
can only refer to SY1: if you have two drives on your system. 


For example, you might write two programs to search through a list of telephone 
numbers for the one belonging to John Doe. Such a program written in BASIC 
might be stored in a file called ‘‘“PHONE.BAS”, while the same program written 
in assembly language could be stored in a file called ‘““PHONE.ASM”’. 


A “fully qualified” file name includes a device specification, as in the following 
examples: 


SY1: PHONE. ASM 
SYO: PHONE. BAS 


However, the device specification may be omitted if you refer toa file that resides 
on the system volume (SY@:). The following two examples are equivalent: 


SYO: PHONE. BAS 
PHONE.BAS 


The FNAME field is comparable to a person’s last name, while the .EXT field is 
similar to a first name. Personal names such as Jim Jones, Nancy Jones, and Jim 
Miller are all different, although they may have something in common. In the 
same way, file names such as TEST.BAS, TEST.ASM, and TEMP.ASM are all 
different, even though they have the same general name or extension. 
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The DEV: portion of the file name is a special case. Normally, one thinks of files 
being stored somewhere, in this case ona diskette. A device specification of SY@: 
or SY1: indicates that the file is stored on one of the two allowable drive units. 
The same file will have a different device specification, depending on whether it 
is mounted on SY¢: or on SY1: 


When no device is specified, HDOS normally assumes that SY9: is the intended 
device. Allowing the same file to be associated with either SY@: or SY1:, depend- 
ing on which it is mounted on, is permitted by the ‘“device-independent”’ 
characteristics of HDOS, as discussed in ‘“Theory of Operation.’”’ Another feature 
of device independence allows you to specify only a device, in some cases, in 
exactly the same manner as you would specify a file name. For example, one of 
the commands discussed below shows you how to copy data from one file to 
another. The general format for the command is: 


>COPYADEV: FNAME. EXT=DEV: FNAME. EXT @& 


If you wished to print the contents of a file on the system console, you would 
simply type: 


>COPYATT: =DEV: FNAME.EXT @& 
Where ‘“‘a’”’ indicates a required space. 


Of course, you must substitute a real file name in this example. The device 
specification TT: refers to the system console. The valid device specifications 
under HDOS are: 


Syo: System drive zero. 

SY1: System drive one. 

TT: Console terminal. 

AT: Alternate terminal. 

LP: Line printer. 

ND: Null device, (used for test purposes). 


The two “directory” devices in the system, SY#: and SY1:, are the storage 
devices. The diskettes mounted on them contain directories that allow many 
files to be referenced. The ‘“‘non-directory”’ devices, TT:, AT:, and ND:, have no 
storage capability; thus, no files are directly associated with them. You may 
specify an FNAME and EXT with them, such as TT:OUTPUT.DOC, but the 
system will ignore everything except the name of the non-directly device. 


The ‘‘null device” is not a ‘‘real’’ peripheral. Any data that is output to ND: is 
simply discarded. Any input attempt from ND: results in an end-of-file condi- 
tion. The null device is provided as a program debugging aid. Programs can 
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write to ND: without using the extra storage space and access time an output file 
would require. 


It is usually best to follow certain conventions when you are naming files. The 
two previous examples were: ‘‘“PHONE.BAS” and ‘““PHONE.ASM”’. The general 
name of each file is the same (PHONE), indicating they have similar uses or at 
least have something in common. If you use the assembler provided with this 
system (ASM), you might assemble the contents of PHONE.ASM to produce an 
executable machine-code program. If you follow the recommended conventions, 
this machine-code program would be stored in a file called ““PHONE.ABS”’. 
(Since no device was specified, HDOS assumes SY¢:). Conventions such as this 
allow you to keep track of the various files without keeping a separate list. 


The FNAME portion of the file name is limited to eight characters, but need not 
consist of more than one character. The ‘.EXT’’ portion is limited to three 
characters, but can be omitted entirely or shortened to one or two characters. The 
characters themselves must be either letters or numbers, and the first character of 
a FNAME must be an alphabetical letter. 


The following is a list of valid file names: 
SYO:PRIME.BAS 
SY1:LETTER.DOC 
INCOMTAX. ASM HDOS assume SY¢: when no device is specified. 
TE: The system console. 


The following is a list of invalid file names: 


SYO : TELEPHONE. LST FNAME is too long. 


COMPUTER. PROG EXT is too long. 

SYO : 8LETTERS . DOC FNAME cannot begin with a number. 
SY1:PROG,NEW.BAS Only letters and numbers are allowed. 
SY3:MYPROG. ASM SY3: is an illegal specification. 


In order to perform any manipulations on files, you must specify the name of the 
file in the proper format. HDOS, however, obeys a convention which makes it 
simpler to run programs that are stored on files. Programs which are written in 
assembly language and then translated into executable machine-code should be 
stored in files with the .ABS extension. An example is INIT. The full name of 
INIT on your distribution diskette is: “SY@:INIT.ABS”’; yet you ran the program 
by simply typing INIT while in the command mode. HDOS recognizes the .ABS 
extension as an identifier for an executable program. 
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In general, there are several conventions for the extension, and you should 
adhere to them as much as possible. These are: 


ABS Absolute binary machine code. 

ACM Assembler-common subroutines. 

ASM Assembly language source programs. 

BAS BASIC programs. 

DOC Documentation, such as instructions for using programs. 
DVD Device driver subroutines. 

SYS Operating system programs. 


Command Mode 


There are a number of commands that will cause HDOS to list the contents of 
files, copy files, rename files, delete files, run programs, configure your system, 
and give status reports. In general, each command is typed on the system console 
ina strict format. If you do not use the correct format or ‘‘syntax’’, then HDOS will 
respond with at least one error message. Error messages are nothing to be 
alarmed about. They simply indicate that you should attempt to perform the 
command again, using the correct method. Refer to “Appendix B”’ for more 
information about error messages. 


Most of the commands follow the same general format, but this can be very 
flexible, depending upon what you wish to accomplish. The most general 
command type is: 


>COMMANDADEV: FNAME. EXT @ 


In other words, most commands deal with files, although there are exceptions 
and several variations. If you omit the DEV: portion of the file name, then HDOS 
will assume you refer to SYf:. To reference SY1:, you must type SY1: specifi- 
cally. It is a legal reference ony if you have a second drive on your system. Other 
variations are possible, and are explained below in ‘‘Wildcards and Multiple File 
Designations”’ (Page 1-22). 


In order to test these commands, HDOS should be booted up and in the command 
mode, with a prompt printed at the left margin of the system console. The 
instructions for using these commands are printed below. You should perform 
the numbered instructions in the sequence given, and refer to the paragraphs 
printed below the instructions for an explanation of the function of the various 
commands. 
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File Listings 


One of the most basic system commands allows you to type the contents of a file 
on the console. Some files contain written text in ASCII, which is meaningful 
when listed. Such files have a .BAS or .DOC extension. Other files are written in 
binary code and have no meaning when listed on the console; these files have 
.ABS, .SYS or .DVD extensions. 


One file that contains meaningful and helpful information is called 
“SY@:SYSHELP.DOC”’. Take the following step to examine the contents of this 
file: 


1. Type TYPEASYSHELP .DOC and a carriage return. 
Note that a device was not specified. In this case, HDOS assumes you 
refer to SY:. The result of this system command is a printed list, as 


follows: 


Valid System Commands: 


HELP Print This List 
BYE Dismount all Mounted Disks, and Reboot 
CAT [DEV: ] List Files on Disk 


COPY TO=FROM Copy FROM file to TO 

DATE [NEWDATE] Display or Set Date 
DELETE FNAME Delete File(s) 

DISMOUNT DEV: Dismount Volume from Drive 


PIP Execute PIP 

MOUNT DEV: Mount Volume on Device 

RENAME TO=FROM Rename File FROM to TO 

RUN FNAME Run Program 

SET dev: .opt Select Option for Device 

SET HELP Documentation for SET Command 
STATUS Display Disk Statistics 

TYPE FNAME © Type file contents on terminal 

VER Display the Current Version of HDOS 
FNAME Same aS RUN SYO:FNAME.ABS 


This is a list of the commands that are permissible under HDOS. Note that you 
can reproduce this listing from the command mode at any time, by simply typing 
HELP and a carriage return. HDOS actually translates the HELP command to 
TYPEASYO: SYSHELP.DOC. 
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Cataloging Files 


The CAT command produces another useful listing of information about a file or 
files. You may use it with or without a device specification, either SY@: or SY1:, 
but not both. This command may or may not be used with a /S modifier, 
depending upon whether you wish to list information about all the files in the 
system or just those which are not essential system files, such as BASIC.ABS. 
You may also specify a file name, as in the following example, if you wish only to 
examine a single file. If no file name is specified, HDOS assumes you wish to 
catalog multiple files. 


1. Type CATAHDOS.SYS/S and a carriage return. The following listing will 
be printed: 


>CATAHDOS.SYS/S @ 
NAME . EXT SIZE DATE FLAGS 21-JUN-79 
HDOS SYS 26 25-MAY—-79 SLW 


1 FILES, USING 26 SECTORS (nnn FREE) 


SY@:HDOS.SYS is a file that contains a major portion of the operating 
system. It consists of 26 sectors and has FLAGS which indicate that it is 
a system file, that the file flags are locked, and that the file is write- 
protected. Refer to the FLAGS section for more information about 
setting and resetting the flags, and the results of such manipulations. 


In the “DATE” column, you will find the date when the file was first 
created. The last line of the listing tells how many files were listed, the 
total number of sectors they occupy, and the number of sectors which 
are free for other purposes, such as program storage. 


2. Type CAT/S and a carriage return. 


The result of this action isa list of all the files on SY@:. Most of them are 
of no particular interest to you at this time because they are system 
files and cannot be manipulated in any useful fashion. If you try to list 
them, you will probably receive a listing of what is called “‘garbage”’ in 
computer jargon. 
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Running Programs 


When you initialized your spare diskette(s) in the ‘‘System Set-Up Procedure,”’ 
you were required to type “INIT’’. Had you desired, you could have typed: 


>RUNASYO:INIT.ABS @ 


HDOS recognizes the contents of any file with the .ABS extension as an executa- 
ble machine-code program. If you type only the FNAME portion of the file name, 
while in the command mode, HDOS assumes you mean RUN SY@:FNAME.ABS. 
Torun BASIC, assuming it has been transferred to your system volume, simply 


type: 


>BASIC @ 


Refer to the appropriate section of your Software Manual for more information 
about system resources such as BASIC. 


Examining and Changing the Current Date 


When you booted up the system, you were required to enter the current date. If 
you wish to examine the date, type DATE while HDOS is in the command mode. 
If you wish to change the current date, simply type DATEA DD-MMM.-YY, using 
the same format you were required to use when HDOS was booted up. 


>DATEA17—JAN-78 @ 


Duplicating Files 


You may wish to have an extra copy of a file for the purposes of modification or 
safekeeping. You may use the COPY command to accomplish this from the 
command mode. In general, all commands are a form of COPY command. When 
you list the contents of a file, you are actually “‘copying”’ the file to the system 
console. When you RUN a program, you are actually ‘“‘copying” the contents of a 
file into the memory of your computer. This concept will be clarified in the 
section entitled ‘Peripheral Interchange”’. 
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For now, you may copy one of the HDOS files by typing 
COPYATEMP.ABS=ONECOPY.ABS and a carriage return. The result will be a 
console output, as follows: 


>COPYATEMP.ABS=ONECOPY.ABS @ 
1 FILES COPIED 


> 


You have created an exact duplicate on the system volume of the file containing 
the program ONECOPY. This file is also executable; you can run the program it 
contains by typing any of the following commands: 


>TEMP @ 
>RUNATEMP.ABS @ 
>RUNASYO:TEMP.ABS @ 


A copy of a system file, such as SY¢:HDOS.SYS, is not particularly useful. 
System files are a special case and may be copied in a usable form only by means 
of the program SYSGEN, as explained in ‘‘System Generation.”’ 


Copying Files to and From Peripherals 


The console terminal is a device with the name TT:, just as the system drive is a 
device with the name SY9:. It is possible to copy files to TT:, and this is exactly 
the effect of the TYPE command. It is also possible to copy files from TT:, as 
demonstrated in the following example: 


>COPYATHISFILE.DOC=TT: @ 
THISAISAAATEST. @ 
AD(CTRL—-D typed) 

41 FILES COPIED 

> 


It is possible that you would wish to test the COPY command without adding any 
files to your system volume. For this purpose, a ‘‘null” device is provided by 
HDOS. The null device driver resides ona file called SY$:ND.DVD. Copying data 
to the null device has no effect except to exercise HDOS and use up a little time 
and electricity. You may test this feature by typing: 


>COPYAND:=SY0:THISFILE.DOC @ 


Operating Instructions 1-13 


Two general-purpose device drivers reside on the distribution disk. ATH84.DVD 
is used to address port 300Q and ATH85.DVD is configured for port 374Q. You 
should rename the appropriate file as ‘‘AT.DVD”, and then re-boot the system so 
HDOS can recognize it. The ‘‘AT”’ portion of the file name stands for ‘Alternate 
Terminal’’. You may copy files to or from this device in much the same way as 
you would copy files to or from TT:, the system console. Of course, to do this, you 
must have a serial terminal device connected to your system. Refer to the “AT: 
Option” on Page 1-28 for more information. 


A COPY command to AT: will type the contents of the file on the alternate 
terminal. 


>COPYAAT:=SYSHELP.DOC @ 
VALID SYSTEM COMMANDS: 


HELP PRINT THIS LIST 

BYE DISMOUNT ALL MOUNTED 
DISKS AND REBOOT 

CAT [DEV: ] LIST FILES ON DISK 


COPY TO=FROM COPY FROM FILE TO TO 

DATE [NEWDATE] DISPLAY OR SET DATE 
DELETE FNAME DELETE FILE(S) 

DISMOUNT DEV: DISMOUNT VOLUME FROM DRIVE 


PIP EXECUTE PIP This list was printed 
MOUNT DEV: MOUNT VOLUME ON DEVICE . on the alternate terminal. 
RENAME TO=FROM RENAME FILE FROM TO TO 

RUN FNAME RUN PROGRAM 

SET DEV: OPT SELECT OPTION FOR DEVICE 

SET HELP OOCUMENTATION FOR SET COMMAND 

STATUS DISPLAY DISK STATISTICS 

TYPE FNAME TYPE FILE CONTENTS ON TERMINAL 

VER DISPLAY THE CURRENT VERSION OF HDOS 

FNAME SAME AS RUN SYO:FNAME. ABS 

> (Prompt appears on original terminal.) 


The command >COPYaLP :=SYSHELP . DOC® will print the contents of this file 
on an H14 Line Printer, if you have one connected to your system. 


Renaming Files 


By using the RENAME command, you can change the name of any file except the 
essential system files. System files cannot be renamed because they are write- 
protected and locked. For an explanation of how write-protection is ac- 
complished, refer to “FLAGS” (Page 1-20). As an example of the use of the 
RENAME command, you may rename the file which was created in the previous 
section by typing the following: 


>RENAMEANEW. ABS=TEMP. ABS @& 
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Deleting Files 


From time to time you may decide you have too many files in your system. You 
can get ride of extraneous files by using the DELETE command. This is the most 
“dangerous” command in HDOS because there is no way to recover a file that has 
been deleted except by copying it from a ‘‘back-up”’ diskette such as the distribu- 
tion diskette. This command is the reason for write-protection of your distribu- 
tion diskette and the system files. Write-protection insures that essential system 
files will not be inadvertently destroyed. As a ‘‘safe’”’ example of this command, 
you may delete the files that you copied in the previous section by typing: 


>DELETEANEW.ABS,THISFILE.DOC @ 
Mounting and Dismounting Diskettes 


The diskette drive units are known as directory devices. HDOS maintains a 
directory on the diskettes which are ‘‘mounted”’ on the drives. The operating 
system also uses a table which ‘‘maps’”’ the location of every file on a diskette. For 
efficiency, parts of the directory and map are kept in memory while HDOS is 
running. When a diskette is removed from the system, or “‘dismounted’’, these 
tables must be written back to the diskette to reflect the most recent changes in 
the status of the various files. You must use the MOUNT and DISMOUNT 
commands to insert and remove diskettes and to prevent data from being lost. 


Use the MOUNT command when you install a diskette. The correct syntax is: 
>MOUNTASY11: @ (A signifies a necessary blank) 


This command informs the operating system that there is a diskette installed in 
SY1:.HDOS reads the table and directory segments from the diskette into the 
computer memory in preparation for your file commands. HDOS will not recog- 
nize any commands dealing with SY1: until the diskette is properly mounted. 


When you are finished using the diskette mounted in SY1:, you must use the 
DISMOUNT command to inform HDOS. This will allow you to mount another 
diskette in SY1:. The correct command syntax is: 


>DISMOUNTASY1: @ 
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This command causes the updated table and directory segments to be written 
back onto the diskette so that any changes to its files will be preserved. DO NOT 
remove the diskette before it is dismounted, or files may be lost. 


The mounting procedure for SY@: is automatically accomplished during the 
“Bootstrap.” You cannot use the MOUNT command with SY@:, but you can use 
the DISMOUNT command. Since SY@: is the system volume, you lose HDOS 
when it is dismounted. Because of this, dismounting SY@: will force an entry to 
the ‘‘Bootstrap”’ procedure. As an example: 


>DISMOUNT SYO: @ 

VOLUME 001, DISMOUNTED FROM SyYO: 

LABEL: MY SYSTEM VOLUME 

INSTALL A BOOTABLE DISK IN SYO:. HIT RETURN TO REBOOT: @ 


TYPE SPACES TO DETERMINE BAUD RATE saaaaa 


ACTION?<BOOT> 


VER 


The VER command displays the current version of HDOS. The correct format is: 


>VER @& 





HDOS VERSION 1.5 
> 


This number is used by HDOS to ensure that you have the correct revisions on 
your system volume. If the version number of a program is incompatible, HDOS 
will issue a SYSERR. 
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Bye 


The BYE command automatically dismounts all mounted devices and returns to 
the ‘‘Bootstrap’’. The correct procedure is: 


>BYE @ 

VOLUME 001, DISMOUNTED FROM SyYO: 

LABEL: HDOS DISK 

INSTALL A BOOTABLE DISK IN SYO: HIT RETURN TO REBOOT: @ 


TYPE SPACES TO DETERMINE BAUD RATE 


ACTION? <BOOT> 
Peripheral Interchange 


To execute the commands explained above, HDOS uses a system program called 
“PIP”, an acronym for ‘Peripheral Interchange Program”. When you type a 
command, the system monitor first decodes it, using a program which resides on 
the file SY9:SYSCMD.SYS. The monitor then either prints an error message, 
which it finds on SY@:ERRORMSG.SYS, or passes the command to PIP for 
execution. PIP normally resides on a file called ‘“SY@:PIP.ABS”. In order to 
execute the command, HDOS reads SY@:PIP.ABS and reads PIP into your sys- 
tem’s memory. The command is passed to PIP, which uses other system re- 
sources such as the device drivers to execute the command. 


Since the file on which PIP resides has the .ABS extension, by convention you 
may assume that it contains an executable machine-code program. You can use 
PIP directly, by simply typing PIP from the command mode. The result should be 
a printed prompt, as follows: 


>PIP & 
- Pe 





To exit from PIP back tothe command mode, type CTRL-D on the system console. 


A prompt (:P:) will be printed at the left margin of the system console when the 
program is awaiting input. The legal commands in PIP are somewhat different 
from “normal’’ system commands. The general form is the copy command, 
where a ‘‘destination”’ is followed by an ‘“‘=”, which is then followed by one or 
more ‘‘source”’ specifications. For example: | 


>P:SYQ:TEMP.ABS=SY0:ONECOPY.ABS @ 


1 FILES COPIED 
oy se 
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This example has the same effect as the COPY command, which was explained 
in ‘Duplicating Files.”’ In this case, the ‘“‘destination’”’ is SY@:TEMP.ABS and the 
“source” is SY$:ONECOPY.ABS. 


If you do not specify a destination, PIP assumes that you refer to the system 
console, and will copy the contents of the file onto it. Since the console is a 
device, like SY: or SY1:, it has a name (TT:), as explained above. Each of the 
following commands has exactly the same result: 


:P:ONECOPY.ABS @ 
>P:TT:=ONECOPY.ABS @ 
>P:TT:=SY0:ONECOPY.ABS @ 
>TYPEAONECOPY.ABS @ 
>COPYaATT:=SY0:ONECOPY.ABS @ 


If you attempt any of these examples, the result will be a listing of binary 
‘‘garbage’’. Hit CTRL-C to terminate the output. SYg:ONECOPY.ABS contains a 
machine-code program rather than written text in ASCII. 


It is also possible to catalog, rename, and delete files under PIP. These functions 
are accomplished by means of a ‘‘switch”’, which is typed after the general copy 
command, or by itself in response to the prompt. The legal switches are: 


/L Gives a catalog listing of non-system files. 

/L/S Gives a catalog listing of both system and non-system files. 
/B Gives a “brief” catalog listing of non-system files. 

/B/S Gives a “‘brief’’ catalog listing of all files. 

/R Used for renaming files. 

/DEL Used for deletion of files. 

/MOU Used to mount the specified device. 

/DIS Used to dismount the specified device. 

/RES Used to reset the specified device. 

/VER Gives the current version of PIP. 


The first four switches allow you to obtain a directory listing of the various files 
in the system. The usage is similar tothe ““CAT” command, which was explained 
in ‘‘Cataloging Files.” 


The /L switch produces a directory listing, or catalog, of those files that are not an 
essential part of HDOS but are listed in the directory. If you performed the 
“copy” example above, at least one file should be listed in exactly the same 
format demonstrated in ‘‘Cataloging Files.”’ The /L/S switch allows you to list all 
the files in the system, exactly like the CAT/S command explained in ‘‘Catalog- 
ing Files.”’ The /S switch is actually a modifier for other switches or commands, 
which causes the system files to be included with those files which you have 
created or copied. It is used in PIP exactly as it is used with the CAT command. 


1 7 1 § CHAPTER ONE 


If you only wish to know whether a file is listed in the directory, you can type its 
name, followed by a/L or /L/S switch, depending upon whether it is a system file 
or one of the “‘extra’’ files. An example is as follows: 


:P:AT:=HDOS.SYS /L/S @ 
NAME EXT SIZE DATE FLAGS 12-MAY-78 
HDOS SYS 24 09-MAY-78 SLW 


4 FILES, USING 24 SECTORS (nnn FREE) 
SPs 


Note that this PIP command had the same effect as the CAT HDOS.SYS/S 
command, used in ‘‘Cataloging Files.’ You can obtain a more abbreviated listing 
by using the /B and /B/S switches. They are used in exactly the same way as /L 
and /L/S; however, they omit details such as the creation date of the file when the 
list is printed. In addition, note that a different destination, AT: instead of the 
default TT: was specified. This list was printed on the alternate terminal, instead 
of the console. 


The /R switch is used in the same manner as the RENAME command. For 
example: 


:P: NEWFILE.ABS=TEMP.ABS/R @& 
EP? 


Note that this switch does not allow you to rename essential system files, and 
that it fails if the source file does not exist in the first place or if the destination 
file already exists. 


The /DEL switch, like the DELETE command, can be dangerous if it is misused. 
You can never recover a file that is deleted with this command, except by making 
a new copy from a back-up file. It is used in a way similar to the /R switch, as 
follows: 


:P:NEWFILE.ABS/DEL @ 
“Ps 


The /DIS and /MOU switches are used in the same manner as the DISMOUNT 
and MOUNT command. They allow you to change diskettes in the drives. For 
example: 


:P: SY1:/DIS @ 

VOLUME O90 DISMOUNTED FROM SY1: 
LABEL: BASIC DATA FILES 

:P: SY1:/MOU @ 

VOLUME O82 MOUNTED ON SY1: 
LABEL: ASSEMBLY PROGRAMS 

oP 
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There is an important difference between the HDOS commands and the PIP 
switches, /DIS and /MOU. In PIP, you dismount the diskette from SY@: and 
proceed. In effect, you are forcing PIP to bea “‘stand-alone utility’. This feature is 
useful if you have two drives and wish to make copies of diskettes. 


However, if you do dismount the system volume, you will enter the boot routine 
when you exit PIP. 


The /RES switch does both, dismount and mount operations. For example, if you 
want to change the diskette in SY1:, 


:P: SY1:/RES @ 


PLEASE REPLACE THE DISKETTE IN SY1: 
VOLUME 020 DISMOUNTED FROM SY1: 
LABEL: F&G 

VOLUME 040 MOUNTED ON SY1: 

LABEL: RECORDS 


?P: 


When the message ‘‘Please replace the diskette in SYn:” is displayed, remove the 
diskette in the drive and install the diskette you want mounted. The /RES switch 
will automatically continue the operations when you close the drive door. 


You can also reset SY@:. If you do this, you are using PIP as a stand-alone 
program, and making HDOS inactive. When you exit PIP, you will enter the 
BOOT routine. 


The /VER switch will display the current version of PIP. The version number is 
used by the software to ensure that you have the correct revisions on your system 
volume. Generally, the version numbers of HDOS, PIP, and utility programs will 
correspond. If you get a SYS ERR #40, it is because your software has incompati- 
ble version numbers. 


When you become accustomed to PIP, you will probably find its ‘“‘shorthand”’ 
notation more convenient than the command mode. Both PIP and the command 
mode have special features which make them more useful than it may seem at 
this point. These features are explained in ‘“‘Wildcards and Multiple File Desig- 
nations.” 


The various file functions of copying, renaming, etc., are not actually duplicated 
between PIP and the system command mode, as it may seem. The various system 
commands, such as COPY, DELETE, etc., actually cause PIP to be run to perform 
the function. If you have only one or two file operations to perform, you will 
probably find it more convenient to use the command mode forms. If you plan 
more extensive file manipulation, it will be faster to run PIP and command PIP 
directly. 
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Remember that you can exit from PIP back to the command mode by typing 
CTRL-D on the system console. You can also obtain a console listing of PIP 
commands by typing HELP from the PIP command mode. This causes the file 
SY@:HELP. to be listed on the console. For example: 


: P: HELP 
PIP COMMAND FORMAT: 
DEST=SOURCE1,...,SOURCEN/SWITCH1. . ./SWITCHN 


Switch Meaning 


/LIST List Device Directory 

/BRIEF Short Listing of Device Directory 

/DELETE Delete Source Files 

/DISMOUNT Dismount Volume from Device 

/MOUNT Mount Volume on Device 

/ RENAME Rename Source File(s) to Destination Name 
/RESET Dismount/Mount Volume on Device 

/SHOW Display Files with 'S' Flag Set 

/VERSION Display the Current Version of PIP 


14 FILES COPIED 
Pt 


Flags 


You may decide to write-protect your own files to prevent them from being 
inadvertently deleted or modified. You can do this with the FLAGS program. In 
order to test FLAGS, you will need a file to manipulate. You may execute the 
following steps, from the command mode, to create a file and examine its 
contents: 


1. Type COPYANEWFILE. DOC=TT: and a carriage return. 
2. Type THISaISaAaTEST. and a carriage return. 

3. Type CTRL-D on the system console. 

4, Type TYPEaANEWFILE.DOC and a carriage return. 


The result of these steps should be printed output on the system console, as 
follows: 


>COPYANEWFILE.DOC=TT: & 
THISAISAAATEST. @& 
<CTRL—D> 

1 FILES COPIED 
>TYPEANEWFILE.DOC & 
THIS IS A TEST. 

= 
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You now have a file on SY@: that can be used to test the FLAGS program, as 
follows: 


5. Type FLAGS and a carriage return. HDOS will turn control over to the 
FLAGS program, which will identify itself and ask if you would like 
instructions. 


6. Type YES and a carriage return. 


FLAGS IS USED TO SET AND/OR CLEAR THE FILE FLAGS. WHEN PROMP- 
TED FOR THE NEW FLAGS, SPECIFY ALL THE FLAGS THAT ARE TO BE SET. 
NOTE THAT IF YOU SET THE “L”’ FLAG, YOU WILL NOT BE ABLE TO CLEAR 
IT AGAIN. THE LEGAL FLAGS ARE: 


Ww WRITE PROTECT FILE. MAY NOT BE REMAMED, REPLACED, OR 
DELETED. 

S SUPPRESS NORMAL LISTING OR COPYING OF FILE. 

L LOCK THE FILE FROM FURTHER FLAG CHANGES. 


As the instructions printed on your console explained, the W flag, when set, 
prevents a file from being written on. You cannot change the contents of a 
write-protected file unless you clear the W flag. The S flag prevents the directory 
listing of files when the CAT command is used, or when the /L or /B switches are 
used in PIP. You can override this flag by using the CAT/S command, or /L/S and 
/B/S, respectively. The L flag locks the other flags. Once the L flag is set, you will 
not be able to change the flags for a given file. If you also set the ‘‘W”’ flag, you 
will not be able to delete the file or rename the file. 


The FLAGS program will prompt you with “FILE NAME?” whenever it is ready 
for a new file. Type the name of the file and a carriage return to examine the flags. 
The CURRENT FLAGS will be identified and you will be prompted to enter new 
flags. If you simply type a carriage return, the flags will be cleared, provided they 
are not locked. The new flags will be whatever you choose to enter from the 
console, as demonstrated in the following examples: 


FILE NAME? NEWFILE.DOC @ 
CURRENT FLAGS = 
NEW FLAGS: W @ 


FILE NAME? NEWFILE.DOC @ 
CURRENT FLAGS = W 
NEW FLAGS: @ 


FILE NAME? NEWFILE.DOC @ 
CURRENT FLAGS = 
NEW FLAGS: SL @ 
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FILE NAME? NEWFILE.DOC @ 
CURRENT FLAGS = SL 
THIS FILE IS LOCKED; ITS FLAGS CANNOT BE CHANGED. 


FILE NAME? <CTRL—D> 


> 


You cannot change the flags further, since you set the ““L” flag. However, since 
the ‘‘W”’ flag is not set, you can delete the file. If you had also set the ‘‘W” flag 
along with the “‘L” flag, the file would be permanently recorded on your system 
volume until you reinitialize the diskette and create a new system volume by 
means of SYSGEN. 


Wildcards and Multiple File Designation 


There are basically two ways to manipulate more than one file with the same 
command. The simplest way to use more than one file name in the source or 
destination fields of the commands. For example: 


>TYPEANEWFILE.DOC,ERRORMSG.SYS/S @ 
THIS IS A TEST. 

128CTRL-C STRUCK 

129CTRL-B STRUCK 

130DATA EXHAUSTED <CTRL-—C> 


The contents of both files are listed on the console. Typing CTRL-C terminates 
the print-out. 


When multiple file designations are used with the COPY command, the result 
will be a file that is a concatenation of the files which are specified on the 
right-hand side of the = symbol. An example which uses the files listed above is 
as follows: 


>COPYABIGFILE.DOC=NEWFILE.DOC,ERRORMSG.SYS/S @ 


The result of this command is a file on SY@: called BIGFILE.DOC, which is a 
combination of NEWFILE.DOC and ERRORMSG.SYS. 


You can also specify multiple file names in PIP, and with the DELETE and CAT 
commands. 


The “wildcard” is another way of accessing multiple files. By typing an * in 
place of either the FNAME or .EXT portions of the file name, or both, the 
command will affect all files that have the unmodified portion of the specified 
file name in common. The following example demonstrates the use of a 
wildcard. 
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>PIP @ 
:P:*.SYS/B/S @ 


HDOS .SYS SYSCMD .oYS HDOSOVLO .SYS ERRORMSG.SYS 
RGT .oYS GRT .SYS DIRECT .oYs HDOSOVLI.SYS 
iP: 


This is a brief listing of the essential system files. Note that all the file names have 
the .SYS extension, and that the FNAME portions are all unique. The wildcard 
allows either portion to be specified ambiguously. 


You can use another type of wildcard asa substitute for a single letter in a portion 
of a file name. This wildcard is the ‘‘?’’. Since the FNAME portion of a file name 
may be up to eight characters in length, and the .EXT portion may be up to three 


ing example demonstrates the use of the ‘‘?”’ wildcard. 
>CATAONECOPY.A?S/S @ 
NAME .EXT SIZE DATE FLAGS 11-MAY-78 


ONECOPY .ABS 19 O9-MAY-—78 SW 
1 FILES, USING 19 SECTORS (20 FREE) 
> 


Multiple file specifications and wildcards can both be used with either the 
command mode or PIP. If you have a dual-drive system, you can transfer many 
files between the two devices in only one operation. First mount an initialized 
diskette on the second drive, and then specify SY1:*.* = SY@:*.* by means of a 
COPY command or PIP. All files, except system files, will be transferred from 
SY@: to SY1:, assuming that some of the files on SY@: lacked the S flag. 


You may use this technique to copy files from your distribution diskette to your 
system volume. It will copy files such as BASIC.ABS and INIT.ABS. You can 
have the distribution diskette and the system volume mounted in either SY@: and 
SY1:, or SY1: and SY¢:, respectively. Of course, the distribution diskette must be 
the source and the system volume must be the destination in order to transfer the 
“extra” files. The example shown assumes that SY1: is the destination. 


Note that you can use the CAT command and the /L and /S switches with 
multiple file designations and wildcards, but they may not refer to more than one 
device in the same command. The next example is invalid and will cause an error 
message: 


>CATASYSHELP.DOC,SY1:FNAME.EXT @ 


This example is invalid because both SY@: and SY1: are used in the same CAT 
command. 
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Onecopy 


This program allows you to copy files from one diskette to another using only a 
single-drive system. ONECOPY will copy multiple files in a single operation, or 
you can specify individual files. (See “System Set-Up” in the Introduction 
Manual for more information.) 


ONECOPY will allow you to copy multiple files in a single operation, if you so 
desire. The following example will copy all the files listed above onto your 
system volume. If you decide to do this, you can delete those files which you 
don’t need by use of the HDOS command mode or PIP. 


To copy all the ‘‘extra”’ files, simply type *.* instead of a specific file name at the 
:OC: prompt. ONECOPY will notify you when this has been accomplished and 
issue another prompt. 


ONECOPY uses the /V,/L,/L/S,/B, and /B/S switches in exactly the same way as 
PIP. Refer to ‘‘Peripheral Interchange’”’ for an explanation of the function of these 
switches. 


ONECOPY has one switch which is different than PIP. This is the /MOU switch. 
It makes it possible to switch to a different diskette whenever a prompt is printed 
at the left margin of the system console. The following example shows how this 
may be accomplished: 


:0C:/MOU @ 


INSERT NEW DISK: {Install an initialized diskette and type a carriage return. } 
:0C: 


The new diskette is now the source. You may specify one or more files to be 
copied from it, and you may use the other switches to determine its contents. If 
you wish to switch to yet another diskette, simply type /MOU again. Note that 
this is NOT the same function as the PIP switch ‘‘/MOU” performs. ONECOPY’s 
/MOU actually does a ‘‘dismount”’ and “mount” function. 
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SYSTEM OPTIMIZATION 


The SET Command 


You can use the SET command to configure your system to the particular input 
and output devices that you have. For example, you can use the SET command to 
specify how many characters your console terminal can handle on a line. If you 
have an H36, or some other terminal that can handle 132 characters ona line, you 
would use: 


>SETATT: AWIDTHA132 @® 


Once you have SET one of these options, HDOS saves the information so you do 
not have to re-SET each time you re-boot HDOS. However, if you change your 
hardware, you can re-use the SET command to change these options. Again, the 
change will become permanent until you re-use SET. 


The HDOS system contains a SET VER that prints the version of the SET 
program. You would enter: 


>SETAVER @ 


The HDOS system contains a SET HELP command that will give you information 
about the SET command. You would enter: 


>SETAHELP @& 


There is also a help entry for each device. To obtain information about the SET 
options for your console terminal, you would enter: 


>SETATT: AHELP & 
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The tables that follow summarize the devices that have SET options. Also, the 
SET options for each device are summarized and the default settings are shown. 
To make the most use of this information, you will have to refer to the section on 
device drivers. You may have to rename a device driver. 


With the exception of the general SET HELP or SET VER commands, the SET 
commands have the form: 


>SETadd:a00000 @ 


In this, ‘‘dd:’”’ represents a device name. Table A, on the next page, lists all HDOS 
devices. Tables B, C, D, and E list the options for each device. 


NOTE: In the following tables, the options that are SET on your distribution 
diskette are marked by an asterisk. 


HELP Prints the help message. 
VER Prints the version number of SET. 
TABLE A 


HDOS DEVICES 


Device Name Description 


SY: System disk drives (all drives installed on system) 
TT: Console terminal, input and output 
LP: Line printed (H14 only) 
AT: Alternate terminal 
TABLE B 
SETASY:AOPTION 
STEPan Sets the step time between tracks on the diskette. Step time for both drives is 


set by the command. Use TEST to determine the value of ‘“‘n’’; it should be 
between 8 and 30, The seek time of the slower drive will be the fastest time 
you Can use on your system. 
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TABLE C 
SETATT:AOPTION 
OPTION DESCRIPTION 
HELP Prints the help message. 
* NOBKS Uses the back-slash character (\) for errors. 
BKS Allows backspacing to correct typing errors. 
* BKM Causes backspace (CTRL/H) to be treated as a DELETE. 
NOBKM Lets HDOS receive the backspace character. 
* MLI Maps lower case input to upper case. 
NOMLI Allows lower case input into HDOS. 
* MLO Maps lower case output to upper case. 
NOMLO Allows lower case output from HDOS. 
* NOTAB HDOS expands TAB (CTRL/I). 
TAB Lets the terminal process TABS. (Faster) 
* 2SB Uses two stop bits. (Universal) 
1SB Uses one stop bit. (Normal) 
WIDTHAn Sets the console width to n characters, 80 is the default value. HDOS starts a 


new line if more than n characters are sent. n must be between 20 and 255. 


FILLacan Sets ‘‘c” as a character that needs fill. This is needed on some slow hard-copy 
terminals. 15Q<@> and 4 are the default values. 


With most terminals, you should change the following SET options. 


SET TT: 15B 
SET TT: FILL 15Q O 


* __ Denotes the option that has been set on the distribution diskette. 
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OPTION 
HELP 


* 6LPI 
8LPI 


PAGEan 


PORTan 


WIDTHam,n 


BAUDAn 


OPTION 
HELP 


* 1SB 
25B 


* MLC 
NOMLC 
WIDTHan 


PADAn 


PORTAn 


BAUDan 


TABLE D 
SETALP:AOPTION 


DESCRIPTION 


Prints the help message. 


Sets the H14 for 6 lines per inch. 
Sets the H14 for 8 lines per inch. 


Sets the number of lines per page to “‘n”. If “‘n” is zero, lines are printed 


continuously. Default value is 60. 
Sets the port address for LP: to ‘‘n’’, Default value for ‘‘n” is 340Q. 


Sets the width control switch position. ‘‘n” is the “narrow” position, and ‘‘m” 
is “wide”. The only legal values are 80, 96, and 132. Default is 80,132. 


Sets the baud rate for LP:. You should only set standard rates (4800, 2400, 
1200, ...) Default is 4800. 


TABLE E 
SETAAT:AOPTION 


DESCRIPTION 


Prints the help message. 


Sets for one stop bit. Note default is one. 
Sets for two stop bits. 


Sets to map lower case to upper for both input and output. 
Allows lower case input and output. 


Sets the terminal width to ‘‘n” characters. ‘‘n’’ must be greater than 20. Default 
is 80. 


Sets to send ‘‘n” ‘‘pad” characters after a @>. Needed with some terminals. 
Default is zero. 


Sets the port address for AT: to ‘‘n”’. If AT: is renamed from ATH84, then the . 
default PORT is 300Q. If AT: isrenamed from ATH85, the default is 374Q. See 
“Device Drivers.”” An H89 will use ATH84.DVD, renamed as AT.DVD. How- 
ever, the H88/H89 hardware port for AT: is 320Q. Therefore, do a 
SETAAT:APORT4320Q command. 


Sets the AT: baud rate to ‘‘n’’. Default is 300. You must use standard rates 
(4800, 2400, 1200, ...). 


* — Denotes the option that has been set on the distribution diskette. 
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Device Drivers 


To facilitate expansion and maintenance, HDOS was designed, in a modular 
fashion, as a number of sub-programs that communicate with one another. Each 
of these sub-programs is responsible for a logically distinct task. For example, 
the sub-program which processes commands is separate from that which han- 
dles I/O. When the command processor needs input, it asks the I/O handler for 
data. Likewise, when the command processor generates output, it passes the data 
along to the I/O handler. In comparing HDOS to a person, one might liken the 
command processor to the brain, the sense organs to the external peripherals, 
and the device drivers, or device handlers, to the nerves which translate and 
transmit the data from the sense organs to the brain. 


HDOS communicates only with device drivers. Any device that is to be inter- 
faced to HDOS must then be interfaced by such a driver. When HDOS writes to 
device xx:, HDOS merely supplies the bytes to be written, calls the driver, and 
then relies on the driver to convert the data into the format required by the 
specific device. Thus, HDOS itself does not have to understand each possible 
device type, only the device driver ‘‘knows how to talk to” that device. 


For this reason, HDOS I/O is quite flexible. Heath will support new device 
configurations by writing the appropriate device driver and supplying it on the 
distribution diskette. To manage the various devices, HDOS maintains a table 
which supports up to seven device drivers. Of these seven devices, two are 
permanently reserved for SY: and TT:, the disk and system console, respectively. 
You would normally select and use two other HDOS device drivers, AT: and LP:, 
the alternate terminal and line printer. This leaves room for three additional 
device drivers that will accommodate your specific system requirements. 


The system distribution diskette is supplied with a number of general-purpose 
device drivers designed to accommodate Heath Products, and general peripher- 


als: 
ATH84 .DVD An alternate terminal configured at address 300Q via an H8-4 Card. 
(Can be reconfigured for address 320Q via an H88-4 Card.) 


ATH85 . DVD An alternate terminal configured at address 374Q via an H8-5 Card. 


LPHRD.DVD An H14 Line Printer interfaced via a Multiport Serial I/O Card at address 
340Q. 


ND .DVD A null device driver (used primarily for test purposes). 
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HDOS builds a table of device drivers when the system is booted up. HDOS scans 
the disk directory for entries of the form: xx.DVD. Therefore, device driver 
program names must be two characters long, and the file name extension must be 
“DVD”. The two-character file name is then used to define the device name. 
(Note: no SY.DVD or TT.DVD files are present because, as these drivers are 
permanently resident, they are incorporated into HDOS and HDOSOVL1 files.) 
Once HDOS has entered the devices in the device table during boot-up, they 
remain usable as long as the current system disk is mounted on SYQ:, and the 
device driver files are present. 


To incorporate any of the optional Heath-supplied device drivers: 


1. Decide which device drivers you need to use, remembering that the 
maximum number of optional user-selectable device drivers is currently 
five. For instance? assume that an H14 interfaced with a Multiport Serial 
I/O Card is to be included in your system. In this case, you would have to 
select LPHRD.DVD as your device driver. 


2. Configure your hardward to match the specifications of the selected de- 
vice driver. (See ‘‘Systems Configuration” in your Manual.) 


3. Copy the device drivers with the appropriate two-letter file name and the 
“DVD” extension. For example: To use LPHRD: 


>COPY LP.DVD=LPHRD.DVD 


Note: SYSGEN will copy all device driver files onto the new diskette. That 
is, if you SYSGENed from your distribution diskette or a diskette that had 
LPHRD.DVD, then the new diskette will have LPHRD.DVD on it. 


4. Enter a “BYE” command, and then re-BOOT HDOS. From this point on, 
whenever the configured system disk is booted, HDOS will recognize the 
valid device drivers. 


NOTE: The HDOS device table is only built on boot-up. That is why you have to 
re-BOOT before you can use the copied device drivers. 
By way of example, an illustration implementing LP: is given below: 

ACTION? <BOOT>BOOT 


SYSTEM HAS 32K OF RAM 


Operating Instructions 


VOLUME 100, MOUNTED ON SyYO: 
LABEL: SYSTEM VOLUME 


HDOS VERSION 1.0 
ISSUE 50.01.00 
DATE (17-OCT-78)? @ 


>COPY LP.DVD=LPHRD.DVD @ It has been assumed that 

>BYE @ LPHRD.DVD has been copied to 
VOLUME 100, DISMOUNTED FROM SyO: this disk from the distribution 
LABEL: SYSTEM VOLUME disk. 


INSTALL A BOOTABLE DISK IN SYO: AND HIT RETURN TO REBOOT: 


ACTION? <BOOT> From this point on, each time that this 
disk is booted, HDOS will know about 
device LP:. 


From now on, the new device will appear as part of the operating system. In 
general, you may now use device LP: throughout HDOS. For example, to list a 
file on device LP: from PIP, type: 


>PIP @& 
:P:LP:=HDOS.ACM @ 





1 Files Copied 
oP: 


Similarly, BASIC programs may now access device LP:. For example, 


140 OPEN 'LP:' FOR WRITE AS FILE #1 
20 FOR I=1 TO 10 
30 PRINT #1, 

40 NEXT I 

50 CLOSE #1 

60 END 


il 


This program will simply print the numbers 1,2,..., 10 on device LP:. 


In summary, device driver I/O lends a significant degree of flexibility to HDOS. 
As the system expands and new peripherals are added, new device drivers will 
be available. 


NOTE: When you finish copying the device driver files that you need onto your 
working diskette, you can delete any other .DVD files. If you get a new device 
later, you may copy the appropriate device driver file from your distribution 
diskette. 
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System Status 


You may wish to check the performance of your system now and then. To do so, 
type: 


>STAT @ 


HDOS will identify itself by printing the version number and the date on the 
system console. It will then print the number of reads and writes performed since 
the system was last booted up. 


The more important consideration, from the standpoint of system performance, 
is the number of read/write errors. HDOS first prints the number of ‘‘hard”’ errors. 
If any hard errors have occurred, the chances are good that you have either a 
diskette with a bad sector or something is wrong with your drive(s) or controller 
board. The recoverable, or ‘‘soft’’ errors are less serious. They can result from 
many causes, as explained in ‘‘Appendix A.’”’ Among these causes are dust on the 
diskette, electrical interference, and momentary losses of synchronization be- 
tween the electrical and mechanical portions of the system. If HDOS experiences 
an error ten times in succession on the same disk operation, the error is classified 
as a hard error. If the number of recoverable errors is larger than about 25 per hour 
of operation, the most probable cure is to slow the track seek time by two 
milliseconds, using the SETASY:aSTEPann option. Thus, if your step time was 
set at 20 milliseconds, change it to 22. Other possible solutions include reduc- 
tions in room temperature and airborne dust. 


Your system should now be configured for your console terminal, and the drive 
seek time should be optimized for your drive(s). The examples you have used 
throughout this procedure are only a small sampling of the possible commands 
and functions. By varying the file names, switches, wildcards, modes, and 
commands, you can explore a nearly endless range of possibilities. 


Some of the system files are not absolutely necessary for everyday operations. 
For instance, after you have optimized your system using the SET options, you 
may delete the file SY#:SET.ABS from your system volume. First clear the SW 
flags. Then use the DELETE command, or the /DEL switch to remove the file. Of 
course you will no longer be able to use SYSGEN with this volume because 
SYSGEN expects the entire system to be intact; so you should delete 
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SY@:SYSGEN.ABS as well. It is not necessary that you delete these files and it 
may even be inconvenient in some applications. However, the removal of nones- 
sential files will provide more free space for program or data storage. Other files 
that you may delete, are: 


FLAGS.ABS {After clearing the SW flags on the others.} 
SYSGEN. ABS 

SYSHELP .DOC 

HELP. 

ONECOPY. ABS 

ATH85.DVD 

ND.DVD 

ATH84.DVD 

LPHRD.DVD 


Of course the functions provided by the programs residing on these files will no 
longer be available on that particular diskette. We recommend that you keep at 
least one master system volume, in addition to the distribution diskette, which 
provides all the available functions. 


Summary 


Your system is now up and running. Your goal should be to familiarize yourself 
with the system so that you will be able to use it efficiently. You can do this by 
going back through ‘‘General Operation,” varying the examples as necessary to 
get “hands-on” experience. This will be very instructive, and can cause no 
damage, due to the error-detection and write-protection facilities of HDOS. If 
you should delete or damage any files, you can always re-SYSGEN from the 
distribution disk. 


Backups 


Remember that, while a powerful system like HDOS keeps your files conve- 
niently at your fingertips, accidental destruction of your files is only a slip of the 
finger away. For this reason, you should always keep copies, called ‘“‘backup 
copies,” of all your important files. Heath has already provided such protection 
for the HDOS files in the form of the write-protected distribution disk and 
individually write-protected files. If you should somehow manage to damage an 
HDOS file from your SYSGENed volumes, you can restore it from the distribu- 
tion disk. 
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APPENDIX A 


Glossary 


NOTE: ALL commands are listed in full capital letters. 


Access: The act of finding a storage location in memory or on a mass-storage 
medium in order to read data from it or write data into it. See ‘‘direct-access,” 
‘“random-access,” and ‘‘sequential-access.” 


Allocation: The act of setting aside a certain amount of memory or an area of 
a mass-stordge device, to be used for running programs or storing data. 


Block: See ‘‘cluster.”’ 


Bootstrap: |§ The method by which communication is established between 
hardware and software. In order for a computer to “run,” it must contain a 
program. In order to load programs into a computer, it must be running. In other 
words, the computer system must “lift itself by its bootstraps’ before it can 
operate. Early computer systems werearted, or ‘‘booted up”, by manually switch- 
ing in a series of binary instructions from the front panel. Nowadays, most 
computers have bootstrap programs already loaded into read-only memories, or 
ROMs. The bootstrap program allows them to start whenever power is turned on. 
Bootstrap, or ‘“‘boot” can also mean a transfer from the basic start-up program toa 
more sophisticated program, such as an operating system. 


Buffer: An area of user or system RAM set aside for communications with 
peripherals, including the disk. A buffer typically could consist of 256 bytes of 
memory, which is the same size as a diskette sector. When it is accessing a file, 
the operating system would read a sector into the buffer so a program could gain 
access to the data. Buffers vary in size, depending on the peripheral with which 
they’re associated, considerations of efficiency, and the amount of available 
memory. A buffer for a terminal might consist of only one byte; while a disk 
buffer should be at least as large as the minimum unit of storage on the disk, 256 
bytes for the diskette and HDOS. 


CATALOG: A command that instructs the operating system to output a 
summary of useful information about a set of files. Examples are name, size, and 
date created. 
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CLOSE: A command that indicates to the operating system that a process no 
longer requires access to the data in a file. If the file was changed during the 
execution of the program, the disk storage area utilized for the file may be 
updated. The directory will also be updated to reflect the changes to the file, such 
as its size and location on the disk media. 


Cluster: A contiguous portion of storage area on a disk medium. In the case of 
HDOS, the minimum cluster size is two sectors of 256 bytes each. 


Command: Information communicated to the operating system by a process 
or from the console, instructing the operating system to perform some action, 
such as opening a file. 


Console: Another word for the peripheral from which a computer system is 
controlled. An “‘operator’’ or ‘‘user’”’ communicates with the operating system by 
means of a console. 


Contiguous: Describes bjects or storage areas that are located next to each 
other. Similar to ‘“‘continuous.”’ 


Copy: The act of placing data contained on one file into another file. The 
contents of the two files are then identical; however, their names and physical 
locations are different. 


Create: The act of setting-up a new file. This involves giving it a name for 
future reference. The operating system will find space for the file on the disk if 
sufficient space is available. It will also update the directory to indicate the 
presence of the new file, unique among the files on this particular disk. 


Default: A condition that exists when no action is taken to override it. For 
instance, a device driver may print lines which are 80 characters in length unless 
it is instructed to make them shorter or longer. The default line length would 
then be 80 characters. 


DELETE: A command that instructs the operating system to remove a file 
from the directory, and to free the area on the disk that it occupies for other 
purposes. 


Destination: A file into which data is to be written. 


Device: A peripheral into which data is to be written, or from which data is to 
be read, by means of input/output commands or instructions. 
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Device Driver: An operating system program that controls a peripheral. See 
“device independence.”’ 


Device Independence: A concept that allows a user program to refer to a 
peripheral by a symbolic name, like a file, instead of requiring a section of the 
program to be written specifically for the purpose of controlling the peripheral. 
The process commands the operating system to input data from the named 
device or output data to it. The operating system, in turn, uses a device driver 
that is associated with the device name to accomplish the I/O. 


Diagnostic: A program that is used to troubleshoot computer systems, or the 
various components of a computer system. The most common ‘‘diagnostics” are 
programs that are used to find possible read/write errors in memory devices. 


Direct-Access: A concept used with some disk systems to describe the ability 
to access a given block of data by using the directory to find its physical position 
on the disk. This eliminates the need to read all the data that precedes the desired 
block as a means of finding it. The term ‘‘random access” is sometimes used to 
describe this capability. 


Directory: A data area used by the operating system that holds the location 
and size of each disk file, referenced by its name. In some ways, it is similar toa 
city telephone directory, but with files instead of people. — 


Driver: See ‘‘device driver.” 
Executive: See ‘“‘monitor’’. 
Extension: The portion of a file name that distinguishes it from another file of 


the same general category. For instance, an assembly language program that is 
used to compute poker odds could be called ‘“POKER.ASM”, while the assem- 
bled machine-instructions for the program could be stored on a file called 
‘“POKER.ABS”’. The extension is the portion of the name that is located to the 
right of the period; it may consist of zero to three characters under HDOS. 


File: | A data structure that is generally associated with a disk or other direct- 
access device. The disk is analogous to an office filing cabinet, with the files 
corresponding to the folders of information on the magnetic recording medium 
of the disk. Data is read from files and written onto files by means of operating 
system commands which reference each file by a unique name. The system 
handles the problems of finding the data and making it available to a process. 
Files must be ‘‘open” to be accessed, and must be ‘‘closed”” when no longer 
needed. 


Free: The act of making an area of memory available for other putposes; as 
when a file is closed, its buffer is ‘‘freed”’. 


Operating Instructions 1-37 


Handler: See ‘‘device driver.’’ 


Hard Error: A disk read/write error caused by a malfunction in the electronic 
or electromechanical hardware. A hard error is usually the result of an error in 
writing caused by dust, static electricity, a scratched disk, or by various kinds of 
electronic interference or noise from electric motors, radio transmitters, and so 
on. 


Initialize: A command to the operating system that instructs it to prepare a 
floppy-disk for new data storage. A new floppy-disk must be initialized before 
you can use it. If the floppy-disk already contains data, the data will be destroyed 
if that volume is initialized. 


Interrupt: A hardware signal to the computer, used extensively by operating 
systems, that causes the current process to cease and another to take its place. 
This facility speeds up the operation and handling of peripherals. The interrupt 
routine is similar to a subroutine in that it eventually returns control to the 
original process. The difference is that an interrupt may occur at almost any time 
and is controlled by external events, such as a keystroke at a terminal. 


Library: A collection of programs that may be stored on the same disk and 
used in conjunction with each other. For example, an operating system can bea 
library of separate programs that are capable of calling one another. 


Load: The process of transferring data from a peripheral into RAM. 
Loader: A program that transfers data from a peripheral into RAM. 


Map: A picture of how data and programs are distributed in memory, or a 
table which shows where files are located on a mass storage device. 


Medium: Generally a magnetic substance, such as a floppy-disk surface, 
upon which data can be permanently recorded. Media can usually be removed 
and replaced by other physically similar media. 


Monitor: The most basic portion of an operating system. A monitor residesin 
memory and may call other programs to accomplish the various functions of an 
operating system. For instance, a complete operating system may consist of 28K 
of machine-executable instructions, with the monitor comprising only 4K of the 
total. When commands are issued to the operating system that are beyond the 
capabilities of the monitor, it may bring in another program from a disk file to 
carry out the command. When the subprogram has completed its task, it returns 
control to the monitor, which calls other subprograms as required. 


OPEN: A command to the operating system that makes the contents of a 
specific file available to a process. 
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Operating System: A rather complicated set of programs that is generally 
associated with disks and other mass storage devices. Its function is analogous to 
that of a policeman directing traffic at a busy intersection. Specifically, it may 
keep track of large amounts of data on disk files, control peripherals, control the 
distribution of memory among various programs, regulate the execution of 
programs, keep track of the amount of time and memory used for various 
purposes, and even improve its own speed and efficiency. The degree of sophis- 
tication is generally directly related to the size and cost of the computer system. 


Overhead: That portion of the computer system’s time and memory required 
to implement the functions of the system. Generally, the greater the overhead, 
the greater the versatility and functionality of the system (and the higher the 
cost). 


Overlay: A fixed-size area of memory that is shared, in turn, by more than 
one process. For example, HDOS may require extra memory for the purpose of 
opening and closing files; the available memory may also be required by a user 
program. When this occurs, HDOS will save the contents of that memory areaina 
file, ‘‘swap-in’’ the appropriate subprogram, open or close the appropriate file(s), 
and then ‘‘swap-in’” the original contents of the area. The process is called 
“overlaying.” 


Primary Memory: The high-speed RAM in which programs are executed 
and data is stored for immediate availability. 


Protection: The means by which a process is prevented from destroying or 
overwriting an important area of memory or disk space. 


RAM: An acronym for “Random Access Memory”: A RAM allows a given 
location to be read from or written to in the same amount of time as any other 
equivalent location, regardless of physical position. This term is sometimes used 
interchangeably with ‘‘direct access’. 


Read: The act of examining the contents of amemory location, or the process 
of transferring the contents of a file into a buffer or area of RAM. 


Real-Time Clock: An electronic counter that interrupts the processor at 
given time intervals to allow a process to keep track of the passage of time by 
counting the “‘interrupts.’’ The computer has a real-time clock which initiates 
interrupts at intervals of two milliseconds. 
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RENAME: A command that changes the name of a file without affecting its 
contents or physical location. 


Resource: A valuable portion of a computer system, such as a peripheral, a 
memory, or a program. Resources can be shared by several processes in advanced 
system; in any case, they are reusable and relatively permanent. 


ROM: An acronym for ‘“‘Read-Only Memory.” A ROM is a memory whose 
contents cannot be changed; however, it can be read like any other memory. 


Secondary Memory: Generally, a large-volume, low-cost, and relatively 
slow memory device. It can be a peripheral such as a diskette. In the case of large 
computer systems, it could be a cheaper version of the primary memory, where 
programs and data are stored when they are not being used frequently. 


Sector: The minimum accessible unit of storage on a disk. The size may be 
determined by physical or logical parameters, or both. In the case of the diskette 
and HDOS, the sector size is 256 bytes; while the minimum file size is one 
cluster, or two sectors. 


Seek: The action taken by the head of a disk drive in finding the correct track 
when data is read from a file or written into a file. ‘‘Seek time” partially deter- 
mines the speed of a disk access. The other main factor, called “rotational 
latency’’, is the time required for the desired sector to rotate under the head. 


Sequential-Access: A type of I/O in which a unit of storage can be made 
available for reading or writing only by reading every unit of storage which 
precedes it on the recording medium. This may result from the physical charac- 
teristics of the storage device, such as a magnetic tape, or it may be a limitation 
imposed by the operating system. 


Soft Error: Anerror in reading a disk that may be caused by dust, noise, or an 
interrupt at the incorrect time. It is similar to the “‘hard error’ except that a soft 
error may be corrected by an attempt to repeat the failed process. If several retries 
do not correct the problem, the error is reclassified as a hard error. 


Source: The original file in the case of operating system commands, or the 
one which is to be renamed or copied. In the case of programs, it means the 
highest level code that is converted by the compiler, interpreter, or assembler 
into machine-executable instructions, or ‘‘object code’’. 
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Supervisor: See “‘monitor.” 


Swap: The act of removing the contents of a memory area temporarily while 
the memory is used for other purposes. See ‘‘overlay.”’ 


Switch: A symbolic code that is used to issue a command to the operating 
system. Also a variable that is interpreted by a process in order to influence its 
flow-of-control. 


Syntax: The formal or “rigid” order in which commands or instructions 
must be written to enable an operating system or other software process to 
recognize them. 


Target: See “destination.” 


Track: A circular area on a disk that consists of a given number of sectors. 
HDOS allows 40 tracks on each disk, with 10 sectors on each track. 


Utility: A general-purpose program that may be shared by a variety of pro- 
cesses. An example would be a program to sort a list of names into alphabetical 
order. The use of a utility program would save considerable inconvenience and 
wasted space, which would be required if each program that needed such a 
capability had to be written to accomplish it independently. See ‘‘library.”’ 


Volume: An interchangeable storage unit, such as a cassette tape or a 
floppy-disk. The volume contains data and is placed ina “‘drive” so the data may 
be ‘‘accessed.” 


Write: The act of transferring data into a memory location or register, or 
outputting it to a peripheral, including a disk. The head on a disk writes binary 
information onto the magnetic medium, which is the physical location of a given 


file. 
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APPENDIX B 


System Error Messages 


This section describes the error messages generated by the HDOS operating 
system. Error message falls into two general categories: those which start with 
?nn,where nn = two digits, and those which don’t. Error messages with no ?nn 
are produced by the program you are currently running. For example, if you are 
using the Text Editor, EDIT, and get a message with no ?nn in it, look in the Text 
Editor Manual for an explanation. Messages with the ?nn in them are produced 
by some component of the HDOS operating system, and are discussed here. The 
messages are grouped according to their ?nn number. 


?00 — Bootstrap Errors 


Error messages which start with 700 are generated by the system while 
it is being booted up. 


?00 DISK READ ERROR DURING BOOT 


An unrecoverable (hard) disk error occurred during the bootstrap 
process. Try booting again. If the problem persists, either your drive or 
your volume is bad. Try booting a different system disk. 


?700 * ERROR * 


An unrecoverable (hard) disk error occured while checksuming the 
disk. The sector number printed immediately after this message is the 
one containing the error. 
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?00 REQUIRED FILE HDOS.SYS MISSING 


The file HDOS.SYS is not onthe volume in SYO:. The disk has not been 
SYSGENed, or has been SYSGENed incorrectly. Reinitialize it and 
then SYSGEN it correctly. 


?00 THIS DISK HAS NOT BEEN PROPERLY SYSGENED 


Some error in the format of the HDOS system files was detected. The 
disk cannot be booted. The disk must be reinitialized, and then 
SYSGENed. 


?00 THIS DISK MUST BE INITIALIZED AND THEN SYSGENED BEFORE IT CAN BE USED 


This disk must be initialized before you can use it. This message 
normally appears when you try to boot up a disk that has been de- 
stroyed by TEST. 


?00 THIS DISK MUST BE SYSGENED BEFORE IT CAN BE BOOTED. 


This disk has not been SYSGENed, and thus can not be booted as a 
system disk. Use SYSGEN to make it a system disk. 


?01 — Build Phase Errors 


These error messages appear during the second half of the boot process when the 
HDOS operating system is being built into memory from the system disk. Most of 
these messages indicate damage to the files on the disk. First, try rebooting the 
system. If the problem persists, then this disk cannot be booted as a system disk. 
If you owntwo drives, mount the disk in SY1: and copy the files you want to keep 
onto a different disk. If you own only one drive, use ONECOPY (run by booting 
up on some other disk) to copy off your important files. Then, reinitialize the 
disk, and reSYSGEN it. 


?01 DISK I/O ERROR DURING BOOT 


An unrecoverable (hard) disk error occurred on the system disk, and 
the boot operation cannot proceed. The disk volume may be bad, or you 
may have a bad drive. Retry the boot. 


?01 DISK STRUCTURE IS CORRUPT 


The directly and/or the free space table on this disk are damaged, and 
HDOS cannot restore the damaged files. Contact the Heath Technical 
Correspondents for advice. 
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?01 FORMAT ERROR IN DRIVER FILE 


The file does not contain a valid device driver program. Currently only 
Heath-written device drivers are supported. You should not attempt to 
write your own. 


?01 HDOS REQUIRES AT LEAST 12K! 


Your H8 system does not contain enough RAM to run HDOS, or the 
RAM is faulty, or it is not addressed correctly. Use a memory diagnos- 
tic to make sure that the RAM is working properly, and is jumpered to 
the correct addresses. 


701 MISSING FILE SYO:HDOSOVL.SYS 


The file SY9;hdosovlsys is necessary to run HDOS, and is not present. 
This normally indicats an incorrect SYSGEN. 


?01 SYSTEM NOT SYSGENED PROPERLY, OR FILES DAMAGED 


A system file is damaged. This can be the result of a software or 
hardware error. 


?02 — Error Messages 


These messages are generated by the operating system and may appear at any 
time. Usually they are in response to some request from the program you are 
running which, in turn, is usually caused by some command from you. Nor- 
mally, HDOS looks up these error messages in the file SY9:ERRORMSG.SYS to 
give an understandable message. If the file SY@:ERRORMSG.SYS is missing, or if 
the system disk has been dismounted, HDOS will simply type the error message 
number. The numbers are listed first, followed by the message they represent. 
Look up the message in the second group for a discussion of its meaning. 


Most of these error messages will be meaningless to you; they are generated by 
HDOS when a program makes a mistake when issuing a request to HDOS. The 
Heath products supplied with HDOS will not make these mistakes. Normally, 
only users debugging assembly language programs will see most of these error 
messages. The ones that the average user will see are self explanatory. 


202 SYS ERR # 001 


End of file. 


1-44 CHAPTER ONE 


702 


?02 


?02 


702 


?02 


?02 


702 


702 


?02 


?02 


?02 


202 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


SYS 


ERR # 002 

No free space on media. 

ERR # 003 

Illegal ‘“SYSCALL” function code. 
ERR # 004 

Channel is already in use. 

ERR # 005 

Device is not capable of this operation. 
ERR # 006 

Illegal device name. 

ERR # 007 

Illegal format for file name. 

ERR # 008 

Not enough memory for the device driver. 
ERR # 009 

Channel is not open. 

ERR # 010 

Illegal function request. 

ERR g 011 

File usage conflicts. 

ERR # 012 

File cannot be located. 

ERR # 013 


Unknown device name. 
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202 SYS ERR # 014 

Illegal channel number. 
?02 SYS ERR # 015 

The device directory is full. 
?02 SYS ERR # 016 

The file’s contents are not correct for this operation. 
?02 SYS ERR # 017 

Not enough RAM for this program. 
202 SYS ERR # 018 

Read failure on the device. 
2702 SYS ERR # 019 

Write failure on the device. 
?02 SYS ERR # 020 

Attempted write-protection violation. 
702 SYS ERR # O21 

Disk is write-protected. 
?02 SYS ERR # 022 

The file is already present. 
2702 SYS ERR # 023 

Aborted by Device Driver. 
?02 SYS ERR # 024 

File is locked against flag change. 
202 SYS ERR # 025 


A file is already open. 
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?02 SYS ERR # 026 

Illegal or unknown switch specified. 
702 SYS ERR # 027 

Unknown unit for this device. 
202 SYS ERR # 028 

Non-null file name is required. 
?02 SYS ERR # 029 

Device is incapable of write operations (or is write locked). 
?02 SYS ERR # O30 

Unit not available. 
?02 SYS ERR # 031 

Illegal value. 
702 SYS ERR # 032 

Mlegal option. 
702 SYS ERR # 033 

Volume presently mounted on the device. 
702 SYS ERR # 034 

No volume presently mounted on the device. 
?02 SYS ERR # 035 

File open on the device. 
?02 SYS ERR # 036 

No provisions made for remounting more disks. 
?02 SYS ERR # 037 


This disk must be initialized before it can be mounted. 


Operating Instructions 1-47 


202 SYS ERR # 038 

Unable to read this disk, it probably has not been properly initialized. 
202 SYS ERR # 039 

Disk structure is corrupt. Contact Technical Correspondence for help. 
?02 SYS ERR # 040 

Not the correct version of HDOS for this program. 
?02 SYS ERR # 041 

No operating system mounted. Required for this operation. 
?02 SYS ERR # 042 

Illegal overlay index. 
2702 SYS ERR # 043 


Overlay too large. 


-?02 A FILE IS ALREADY OPEN 


The specified channel is already open. 


?02 ATTEMPTED WRITE PROTECTION VIOLATION 


You requested a write-type operation on a write-protected file. These 
write-type operations are WRITE, DELETE, RENAME, and REPLACE. 


?02 CHANNEL IS ALREADY IN USE 


The I/O channel specified in the HDOS call is already in use. 


?02 CHANNEL IS NOT OPEN 


The I/O channel must be opened before you issue this request. 
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?02 DEVICE IS INCAPABLE OF WRITE OPERATION (OR IS WRITE LOCKED) 


702 


?02 


702 


202 


?02 


?02 


702 


202 


The device is write-disabled, or is incapable of accepting write opera- 
tions. 


DEVICE IS NOT CAPABLE OF THIS OPERATION 


The device specified is not capable of the operation. For example: a 
read request from a write-only device such as a line printer, or a 
directory operation such as LIST on a non disk device. 


The most common cause of this message is a write operation on a disk 
that has the write-protect tab installed. 


DISK IS WRITE PROTECTED 


The write operation was refused because the disk is write protected. 
DISK STRUCTURE IS CORRUPT. CONTACT TECHNICAL CORRESPONDENCE FOR HELP. 


The internal map of the disk has changed in HDOS. The most common 
cause is incorrectly dismounting or mounting diskettes, especially 
when they have the same volume number. 


END OF FILE 
An End-of-File was read on the file. There are no more sectors to read. 


FATAL SYSTEM ERROR 


A read or write error occurred on a distribution or a system diskette. 
The distribution diskette must always be inserted in SY@:. 


FILE CANNOT BE LOCATED 
The specified file name is not on the specified device. 
FILE IS LOCKED AGAINST FLAG CHANGE 
The file cannot have its flags changed because the L (locked) flag is set. 


FILE OPEN ON THE DEVICE 


A dismount or reset was issued to a device, and a channel was not 
previously closed. 


?02 


702 


202 


202 


702 


?02 


?02 


202 


702 
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FILE USING CONFLICTS 


Conflicting requests have been made for this file. A file may not be 
deleted, replaced, written to, or renamed while it is open for read. Also 
note that a program may not delete, replace, write to, or rename the file 
it was loaded from. 


ILLEGAL 'SYSCALL' FUNCTION CODE 


An illegal request code was given in an assembly language SCALL 
statement. This will only occur with user-written programs. 


ILLEGAL CHANNEL NUMBER 


A request specified a nonexistent channel number. 


ILLEGAL FORMAT FOR DEVICE NAME 


The device specification part of the file name is not correctly specified. 


ILLEGAL FORMAT FOR FILE NAME 


The file specification was in an illegal format. 


ILLEGAL FUNCTION REQUEST 


A request was made to HDOS to perform an illegal function. For 
example: requesting a write to a channel opened for read. 


ILLEGAL OR UNKNOWN SWITCH SPECIFIED 


An illegal or unknown option switch (/xxx) was specified in the com- 
mand line. 


ILLEGAL OPTION 

A specified SET option was not recognized by HDOS. 
ILLEGAL OVERLAY INDEX 

A call was made to an invalid index number. 


ILLEGAL VALUE 


The value entered was out of bounds. Most commonly, this error 
occurs in a SET command. 
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202 


?02 


702 


702 


202 


202 


702 


702 


202 


NO FREE SPACE ON MEDIA 


All sectors on the volume are in use, so the write request cannot be 
honored. 


NO OPERATING SYSTEM MOUNTED, REQUIRED FOR THIS OPERATION 


HDOS and the required overlays are not present. Check the directory of 
SY@:. 


NO VOLUME PRESENTLY MOUNTED ON THE DEVICE 


A dismount was issued to a device that had nothing previously 
mounted. 


NO PROVISIONS MADE FOR REMOUNTING MORE DISKS 


The overlays of HDOS required to process a mount command are not 
present. 


NON-NULL FILE NAME IS REQUIRED 
Diskfiles require that the name field in the file specification must 


contain at least one character. The extension may be empty (null). 
Non-disk devices allow empty (null) file names. 


NOT THE CORRECT VERSION OF HDOS FOR THIS PROGRAM 
The version numbers of HDOS and the requested program do not agree. 
You should make sure that all files have the most recent version 
numbers. 


NOT ENOUGH MEMORY FOR THE DEVICE DRIVER 


Not enough free RAM exists to load the necessary device driver. 
NOT ENOUGH RAM FOR THIS PROGRAM 
There is not enough free RAM to load this program. 


OVERLAY TOO LARGE 


The assemble overlay exceeds maximum size. It cannot be larger than 
HDOSOVL§.SYS: 
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- ?02 READ FAILURE ON THE DEVICE 


An unrecoverable (hard) error occurred on the last attempted read 
operation from this device. 


?02.THE FILE IS ALREADY PRESENT 


You attempted to rename a file to a new name that already exists in that 
volume’s directory. 


?02 THE FILE'S CONTENTS ARE NOT CORRECT FOR THIS OPERATION 


An attempt to RUN a file which is not an absolute binary program. Only 
absolute binary (assembly language) files may be run (the programs 
supplied by Heath are all in this format). Note that the extension .ABS, 
by convention, represents absolute binary files. But an absolute binary 
file does not have to have the .ABS extension, and a file may have the 
-ABS extension and yet not be in absolute binary format. 


?02 THE VOLUME DIRECTORY IS FULL 


The volume’s directory is full; no more file names can be added until 
some are deleted. A volume directory for the diskette holds about 198 
file names. 


?02 UNABLE TO READ THIS DISK, IT PROBABLY HAS NOT BEEN PROPERLY INITIALIZED 


An attempt was made to mount a diskette that appears to be unin- 
itialized. Be sure that the diskette was re-initialized after ‘“Test”’. 


?02 UNIT NOT AVAILABLE 
The device unit requested is not installed or not operable. 
?02 UNKNOWN DEVICE NAME 
An unknown device was specified in the file name. Note that a device 


driver for each device you wish to use must be on the system disk when 
it is booted (except for SY: and TT:, which are built into HDOS). 


?02 UNKNOWN UNIT FOR THIS DEVICE 


This device type does not have the specified unit number. 
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?02 WRITE FAILURE ON THE DEVICE 


An unrecoverable (hard) error occurred on the last attempted write 
operation on this device. 


?02 VOLUME PRESENTLY MOUNTED ON THE DEVICE 


A mount was issued to a device that has not been dismounted. 
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APPENDIX C 


HDOS Cookbook 


This Appendix provides you with a number of examples of possible HDOS 
functions and commands. The command mode, PIP, ONECOPY, and SET will be 
covered. The exact command syntax, including the prompts, will be printed, 
along with an explanation of the results of the command. 


These examples are not intended as explanations of how HDOS accomplishes 
various functions. Rather, they are intended as a survey of some of the more 
useful commands and options. For a more detailed explanation of HDOS, refer to 
the ‘‘General Operation’’ section. In these examples, DEV: refers to a device, 
FNAME refers to the general name of a file, and .EXT refers to the extension 
which distinguishes the file from others of the same general name. 


Listing Files 


The following commands allow you to type the contents of various files on your 
system console. It is necessary to specify SY1: if you wish to type files from that 
device. You may type files on SY@: without an actual specification of SYO:. 
Wildcards and multiple file designations are allowed and cause the files to be 
typed one after the other. Note that you may use CTRL-C to stop the listing, 
CTRL-S to halt it temporarily, and CTRL-Q to get it restarted. It is not recom- 
mended that you type files with the .ABS, .DVD, or .SYS extensions because of 
their generally non-ASCII contents. If you wish to type the contents of a system 
file, you must specify the /S modifier. 


>TYPEAFNAME. EXT 

>TYPEA* . EXT 

>TYPEAFNAME. * 

>TYPEA*. * 

>TYPEASYO: FNAME. EXT 

>TYPEAFNAME. EXT/S 
>TYPEASYO: FNAME. EXT/S 

>TYPEASY1: FNAME. EXT 

>TYPEASY1: FNAME. EXT/S 
>TYPEAFNAME.EXT, . .. , FNAME. EXT 
>TYPEASY1:*.EXT, . . . , SYO: FNAME. */S 
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Cataloging Files 


The following commands produce a catalog listing of a specific file or files on 
either SY@: or SY1:, depending upon which is specified. HDOS defaults to SY®: 
if neither is specified. You must use the /S modifier if a system file is to be 
catalogued. You may catalog other files with or without the /S modifier. If the * 
wildcard is used in FNAME or .EXT, multiple files may be cataloged if two or 
more have either part in common. Note that there are a great many possible 
combinations of commands that are not shown. 


>CAT 

>CATaSsyYO: 
>CATaSYO:*.* 

>CAT/S 

>CATaSYO:/S 
>CATaSYO: *.*/S 
>CATaASY1: 
>CATASY1: *.* 
>CATaSY1:/S 
>CATASY1:*.*/S 
>CATAFNAME. EXT 
>CATaASYO : FNAME. EXT 
>CATASYO: FNAME. * 
>CATASYO: * . EXT 
>CATAFNAME. EXT/S 
>CATASYO: FNAME. EXT/S 
>CATASY1: FNAME. EXT 
>CATASY1:FNAME.EXT/S 
>CATAFNAME.EXT, . . . ,FNAME.EXT 
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Mounting and Dismounting Diskettes 


If you wish to use SY@: or SY1:, itis necessary to “mount” them on the H17 drive 
units. The system volume is automatically mounted during the ‘‘Bootstrap” 
procedure. When you are finished using a volume, it is necessary to ‘‘dismount”’ 
it in order to power-down the system or mount a new volume. If you do not 
dismount the volumes, data which is held in memory may be lost because HDOS 
is given no change to update the volume(s). The correct procedures are listed as 
follows: 


>DISMOUNTASY1: @& 

VOLUME 002, DISMOUNTED FROM SY1: 
LABEL: SPARE SYSTEM VOLUME 
>DISMOUNTaSYO: & 

VOLUME 001, DISMOUNTED FROM SyYO: 
LABEL: MAIN SYSTEM VOLUME 

TYPE SPACES TO DETERMINE BAUD RATE 
>MOUNT SY1: @ 

VOLUME 002, MOUNTED ON SY1: 

LABEL: SPARE SYSTEM VOLUME 
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Running Programs 


Executable binary programs have the .ABS extension under the HDOS conven- 
tions. This extension allows you to type the FNAME portion of a file name from 
the command modeas an abbreviated command torun the program contained in 
the file SY¢:FNAME.ABS. In order to run a program contained ina file on SY1:, 
you must specify SY1:. For example: 


>FNAME 

>RUNAFNAME 
>RUNAFNAME. ABS 
>RUNASYO: FNAME. ABS 
>RUNASY1: FNAME. ABS 


Duplicating Files 
It is possible to copy the exact contents of one or more files with a single 
command. The general command syntax is: 
>COPYADEV: FNAME. EXT=DEV:FNAME.EXT @ 
Some examples of this command are: 
>COPYAFNAME. EXT=FNAME. EXT 
>COPYAFNAME. EXT=SY1: FNAME. EXT 
>COPYASY1: FNAME. EXT=AT: 


>COPYASY1:*.*=SYO:*. EXT 
>COPYAAT:=*. * 


Note that when you write more than one file specification on line, HDOS adaptsa 
slightly different scheme for default devices and extensions. The default device 
for the first file is “SYQ’’, and the default extension is NULL. For the following 
file specifications, the default device and extension become the fields from the 
previous file specification. For example: 


>COPYaATT :=SY1:TEMP.TXT.TEMP2 @ 
is equal to 


>COPYATT :=SY1: TEMP .TXT,SY1:TEMP2.TXT @ 
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Deleting Files 


It is possible to delete one or more files from your system using only one DELETE 
command. You must be careful with this command because valuable informa- 
tion could be lost if you delete the wrong file(s). System files are protected by 
flags and cannot be deleted until the flags are changed. Those files that are 
locked and write protected (see Page 1-48 to 1-50) can never be deleted unless the 
diskette is reinitialized. Here are a few examples of the DELETE command: 


>DELETEAFNAME. EXT 

>DELETEASYO: FNAME. EXT 
>DELETEASY1:FNAME.EXT, . . . ,FNAMEn. EXT 
>DELETEA* . EXT 

>DELETEAFNAME. * 

>DELETEa*. * 


Peripheral Interchange 


In general, you can use PIP to accomplish the same functions and commands that 
are supported by the command mode. This does not include running program, or 
such general-purpose functions as SET or DATE. However, PIP is the basis for all 
command mode file manipulations. The following list includes some useful PIP 
commands: 


: DEV: FNAME. EXT/L 

: DEV: FNAME. EXT 

: FNAME. EXT 

:FNAME.EXT, . . . ,FNAME.EXT/L/S 

: DEV: FNAME. EXT=DEV: FNAME. EXT/S 

:*.*/B/S 

: FNAME. */L 

oe hae 

:/DIS 

: HELP 

: /RES 

: /MOU 

:DEV:FNAME.EXT, . . . ,DEV:FNAME.EXT/DEL (NOTE: You may not 
refer to more than 
one device in the 
same command.) 


uvuUyvV’ VU UU Ul UO Uo 


:P: DEV:=/SWITCH 
: NEWNAME.. EXT=OLDNAME. EXT/R 
:P:LP:=/L 


‘U 
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Onecopy 


This program is a stand-alone utility that allows owners of single-drive systems 
to copy files from one diskette to another. To use this program, load information 
from the source diskette into the memory, and then swap-in the destination 
diskette. The data will be subsequently dumped from memory into a file on the 
destination. The destination file(s) automatically has (have) the same name as 
the source file(s). Multiple files can be copied in a single operation, depending 
upon the specification of the source(s). The number of swaps will depend upon 
the amount of installed memory. The following list demonstrates some of the 
possible commands under ONECOPY. 


>O0C: FNAME. EXT 
:OC: FNAME. * 
:0C:*. EXT 
:0C:*..* 
:0C:*.*/L/S 
:0C:/B 
:0C:/B/S 

:0C: /MOU 


System Optimization 


There are several commands which allow you to optimize your disk drive system 

_to function at top performance. You can adjust the seek time of the drive(s) to 
operate at the highest reliable speed. You can also configure the operating 
system to utilize a terminal that can backspace and support lower-case ASCII. 
Only valid HDOS device drivers may be SET. Use the following command to 
obtain HELP with the SET command. 


>SETAHELP & 
GENERAL COMMAND FORMAT 
SETAXX: AOPT 
XX: -—-— DEVICE NAME 
OPT -—- DESIRED OPTION 
FOR HELP WITH A SPECIFIC DEVICE.TYPE: 
SET XX: HELP 


To determine the version of Set, type: 


SET VER 
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APPENDIX D 


Transferring Cassette Data to Files (BASCON) 


The purpose of this Appendix is to demonstrate how you can transfer BASIC 
programs and TED-8 text from cassette tapes onto diskette files. The transfer 
capability applies only to Heath standard cassettes, and does not apply to binary 
data such as machine-language programs. Tape data files created with Extended 
BASIC 10.02.XX or later are not converted. This includes TYPE 5 cassette files 
and the data portions of TYPE 6 files. All program text is converted to diskette 
files. HDOS BASIC has a different method for handling data, and these tape data 
files would be unusable. 


No provision is made for transferring in the opposite direction; you cannot 
transfer disk files onto cassette tapes. Also, after the BASIC programs have been 
transported, they may have to be modified slightly to use HDOS input/output 
commands. Refer to the appropriate Heath Software Manuals for more informa- 
tion. 


Two program files are included with your distribution diskette to provide 
transportability. The program which transfers cassette BASIC programs to 
HDOS files is called BASCON, and resides on the file called BASCON.ABS. The 
TED-8 text transfer program is called TXTCON, and resides on TXTCON.ABS. 


Before attempting to use these programs, you should perform the entire ‘‘System 
Set-Up Procedure.” Transfer the data to a system volume that has been created 
with SYSGEN, or to a data volume that has been initialized and mounted on 
SY1:. DO NOT attempt to transfer data to the system distribution volume; HDOS 
does not support this option and you may accidentally destroy your system 
distribution volume. 
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Conversion of BASIC Programs (BASCON) 


BASCON operates with a memory overhead of approximately 6K bytes. This 
means that you can expect a minimum system with 12K bytes of memory to 
convert BASIC programs which run in 6K or less. A 24K system will convert 18K 
BASIC programs. The amount of storage space remaining on a diskette also 
limits the size of programs that can be converted. The number of free sectors ona 
diskette is obtained by the CAT command or the /L PIP switch. Each free sector 
consists of 256 bytes. Use the following procedure to transfer cassette BASIC 
programs to a diskette: 


L, 


Set-up your cassette deck just as you would to load tapes from BASIC. 
The tape should be installed and the PLAY button should be depre- 
ssed. 


Type BASCON and a carriage return from the HDOS command mode. 
The conversion program will identify itself and ask if you want in- 
structions. 


Type YES and a carriage return if you want instructions, or hit a 
carriage return if you do not. 


BASCON will ask for an output file name. This refers to the name of the 
file that will be stored on your diskette. You may reply witha filename — 
in any of the three following formats: 


DEV: FNAME. EXT 
FNAME. EXT 
FNAME 


If you specify only the FNAME, BASCON will supply the extension 
.BAS to signify that the file is a BASIC program and it will copy the file 
onto SY#:. You must specify SY1: as the device if you want the file 
copied there. You must also specify the extension if you want it to be 
other than .BAS. 


Type the output file name and a carriage return. 


You will be asked for an input file name. This refers to the name of the 
BASIC program on your cassette tape. If you want a specific program 
transferred, you must supply its name, without quotation marks. If you 
want to transfer the next program on the tape, simply hit a carriage 
return. 
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5. Respond as explained above. 


The cassette deck will begin to run as BASCON searches for the 
desired BASIC program. You will be notified when it is found, as it is 
being read into the memory buffer and when it has been successfully 
converted to a disk file. You will also be notified if BASCON finds 
TED-8 text files or Extended BASIC TYPE 5 data files. These will be 
skipped and BASCON will continue searching for the desired BASIC 
program. 


When the program has been converted to a diskette file, BASCON will ask fora 
new output file name. You may then restart from step 4 of this procedure and 
repeat the cycle witha new BASIC program, or you may type CTRL-D to escape to 
the HDOS command mode. 


Conversion of TED-8 Cassette Text Files (TXTCON) 


The TXTCON program operates in a minimum system with no apparent over- 
head. This means that you can convert any amount of text with the minimum 
12K system, unless you run out of storage space on a diskette. Remember that 
each diskette sector consists of 256 bytes, and that the number of free sectors is 
printed at the end of a CAT command. Use the following procedure to convert 
TED-8 cassette tape records to diskette files: 


1. Prepare your cassette deck just as you would to load cassette tapes 
from the TED-8 Text Editor. 


2. Type TXTCON and a carriage return from the HDOS command mode. 
The TXTCON program will identify itself and ask if you want instruc- 
tions. 


3. Type YES and a carriage return if you want instructions, but type only 
a carriage return if you do not want instructions. 


TXTCON will print simple instructions if you asked for them; then it 
will ask if you want tabs inserted into the text. The ASCII tab code is 
used in exactly the same way as the TAB key ona standard typewriter. 
They allow several blanks to be printed each time a tab character is 
encountered. Tab codes are used to provide regular spacing between 
columns of text, as in an assembly language listing. They also save 
space because one tab character can replace as many as many eight 
blanks. If you answer YES, the TED-8 compressed text tab codes will 
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be transferred to the diskette as ASCII tab codes. If you answer NO, the 
compressed text tab codes will be converted to the appropriate 
number of ASCII space characters before being written onto the output 
file. HDOS allows you to handle ASCII tab codes by means of the SET 
options, thereby conserving space on your diskettes. 


4. Type YES and a carriage return if you want tabs inserted. Otherwise 
hit a carriage return. 


You will be asked for an output file name. This refers to the name of the 
file that will be stored on the diskette. The file name may be formatted 
in either of the three following ways: 


DEV: FNAME. EXT 
FNAME. EXT 
FNAME 


If you do not specify a device, the file will automatically reside on SY:. You 
must specify SY1: if you want the file to reside there. If you do not specify an 
extension, TXTCON will assume you want a null extension, meaning a nonexis- 
tent extension. 


5. Type the desired file name and a carriage return. 


TXTCON will request an input file name. This refers to the name of the 
text file on the cassette. If you want to convert a specific text file, you 
must enter its name without quotation marks and then a carriage 
return. If you want the next available text file, simply hit a carriage 
return. 


6. Specify the desired text file as explained above. 


The cassette deck will begin to run. You will be informed when the 
desired text file has been found and when it has been successfully 
converted to an HDOS file. You will also be notified if TXTCON finds 
anything other than TED-8 text. The program will ignore other files 
such as BASIC programs and continue to search for the specified text 
file. 


When this is completed, TXTCON will request another input file name. At this 
point you may restart the cycle at step 4 of this procedure, or type a CTRL-D to 
escape to the HDOS command mode. 
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APPENDIX E 


H17 ROM Code Listing 
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031,001 365 453X FUSH FSW FLAG OVERFLOW 
seein: 034.002. ...303..344..030....454X%............UMEL MUGS L. 0.0... cee ee PROLESS. NEXT. RUT. cc ccc cess cccccceccceccccccccnuceteccucescuceeececeeecseeecneetenseeeseste 


CC Ce eo ee ok aC 
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Rierr ed HIPROU HL ROM COTE. LISTING» 000 cece ccc eceecsee cee ceececeeceeceesseecertecssectresseess AEATH HSASM, Vi+4...01720/78........... FAGE 10 
COMMON DECKS $MUSS 15:54:17? 11-mMAY-~78 
Pe cattae Veen inte O:21,,.008%.. 344.000.000.000... 456% MUESS. POP SW ll CAF) =, QUERELOW STATUS occ cc cece ence cee cee ceccccccccecavacuutecccaeeaves 
O31.004 311 457% RET 
Meee doie anise ARE eke tie eh or lelis Se aasictad A6OX 4% 000... SMUSSE ~ MULTIPLY 8X16 UNSIGNED cece ee eee ee 
PO a 
silt Mes tt SE Ris ip BI ST ies Uta Pee 462x * SNUBS MULTIFLIES @& 16 RIT VALUE BY AS 
poses PS EEE EEOOSEESS 
Bg ate ne ee cia ha Ne he Rena Seana UO Re A oR ot ot hala tere atte aorianb ae Padua ah basen 
eg AERA UCAS LC MULLELEE RU ect rater rete te 
Bek Veen ere Sea eee es: AGOX BSED, =, MULTIPLICAND oo, wet 
uid ale Bier ht iene ee alent ae poesare BTR OCCHES eo BESULY Barely ita auduac te aaa apetiatak ateatst ate eats tae Ae tah Toe eect beh a wich Loe 
ER RT) ane Re RO re ey Pee tte ee: 4G8K OK We SET IF NOT OVERFLOW 
sees ides Pre SET Ta EEE 
Meech nee Mend eee aes fetter chet detaeeE A acatnt ea bancnes BO ihe yee RE anc he a a gon ee — 
EES CESS CESS SEES ESOS SO OSOOSOOESIO® 
021.007 041 000 000 472K $MUS4 —_LXI HO (HL) = RESULT ACCUMULATOR 
lectus nouec lak! St ae oe LE Ct AAS 
932.013 104 i... BOR 6 oe i! 2 al HOV Eo : (B) = OVERFLOW FLAG 
t hsnasieire een: Ooi ety Bes TEE MUSOU GRR ED EE ERO coer sees cette et tee teeter cneeeesees coeesneeenecseenteneessetiaees 
$75 
Se iui ty Mee tes PT rea COOSC¢ YE SOE SY TESTE ESEEE SEES SSESOEESSEOOSS OOOO OSESSES OSES OSEOSSOOOOOSSEOOSOOOSOOSOSOSSOOOOOSOOOSOOOSSSSOSOSOS SSS ESESOSSO OOS OSEOSSOOOSOOSOOSSSS 
Posed Theil ek Sede 031,014 322 026 O81 | APEX INC .MU8S2 IF NOT TO Abr 
Seago ay Rogge eee POE eee eeeeereeee ete MAT TEE LSS cit tescatt are fy lena dhe ei Nh Se balee wllade Mea anata Aedes WM Read bate kc ea 
ee eA: O31, 022 322 026 031 aBOX oo NC UBS NOT OVERFLOW 
Bey ene bey Peete ae EES 
aed in bistiece 031,026 26? 482% MUSS2 — ORA A 
sheets ISS EOE CER SERIE Ore ¢ CLES EESEERYD CESSES OT OOS EES ECSOOEO TORT OSES SSCS OEOE OES SOCOSEOOOOSOSSOSSOSSOSEOSSSOEOOS OOOO OOSOESIOSSOSIOSE 
aaeeed 031.032 353 ABAX XCHG 
rete: I Rk Ct So EES SEES SOS OSEROSESS 
stethitaTsectes ODL OSA BOOS. 8 ace fo ine, YOY co acninale Salek wise Oe Ma Wht ise ad A 8a Loads Semanal 
OE Oe RED OTS OSL UABIR UT ne bag GOR TE NOT QUERRLOU UU ee eee 
ead ieetee: ECS A 1 ne | 2 ee a -n e ee . 
Fee OTTO NGS O14 O4T ABER ERE Oye 
Pet pasase cela silks e acaergs te alte eee BO Ss dae Na OBO cehitcad ohr ate Nante ai ache ameciode Dene tea as ee tiala oa aang a MUA aa chaste 
SNL 644 BES 4a ee MUSE ORE . SET MEX FLAG IF NOT GUERELOW Uo reece teeters 
Te eee OST OAS SOM aes ik AAR ores POE ie ful Et tel igs any ch nbbd ced die Ee oa ah Be heehee coke vs ? 
O81 1.048. BOF pene PE 
SOEK Kx SRSTALC WL URESTORE BLO REGESTERS tees 
ieee bce Mn cud antec emadais Veen nein bees eaaaiaen Se EOE LT TEE ORE SRR EDS OORT ire ETT OURS STON Cer tReet a ee re rey, 
498X x $RSTALL RESTORES ALL THE REGISTERS OFF THE STACKY AND UCU reser eereesssseseses 
A99X xk RETURNS TO THE FREVIOUS CALLER. 


DOR e meh em em ee me EEE HE EEE EERE HEE ETHER EEE EERE EEE EHEC EEE EERE EEE EH EERE EE HERE ESET RHEE SEES HEHEHE RRR EEE EEE EERE EEE TEESE RHR R EEE HEHEHE REE EERE EEE H REED EEE EOE RH eee CHE e reed ee eeES Pe UHH Oe orandenne 


NS 2 i i i Oi a ee i ee, ee ie oe er ee oe ere 


502X x (SF+2) = RC 
iia Seb na Bee ie AS oi Ss aE AAE aa Ratner altal inisres st OAS aun eslslacieena tei chuath Oy tet ho venige saat’ totais said ahha N ee Unwed inntbatv am sani fanaa yong nah baae abana tele amaaW ae aaaY 
Hoek. CED LGR Teer ee eete tee teeeeeeseeseeeeeeceeeeereeseteeesanteeeseteareetsenees cteneesetanecnetieeneeeee tnt 
SOSX_ x (SF+8) = RET 


Oo me eee meee meee mame H EERE SHER ORES EERE SH HEHE EE EERE EES OES EEE EEE EE EERE REESE ee meee Ht HHS Ee RR E SHEE TEETER EEE TERE Eee EE EEE ETERS ES EEE EE EEE HEHEHE HERE EEE HCE EEE ESOS SHO ee eee eH Dene neereeenereaeesee 


i ee ee i i i i i i i i ei i ee i oe 


Cm mmm mem me meme meee ee eee me Ree a eRe HERRERA ERE HERR HR EEE ESSE ES EEE EEE LESSEE EEE EEE SEER DREHER ESOT H HERE EEE EE HOE HEE SE REESE EEE TESTER REE RHEE EEE REET HESS ERE OREO EES Cee eeensreeesnenssenseeeeseresee 


JNO Y3LdVHO él-l 


Pr oe OS ee ee 


H1i7ROM ~- H1i7 ROM CODE LISTING. HEATH H8ASM V1.4 01/20/78 PAGE il 





aR COMMON: DEON. ob he scbuas shoe snail elene ga uve dion cial wh pare So elon Se pe Fao eran ae SES woes seen ee ED PMO 7O oo eid cs eclsle ide ide aie ue vena wareoanue’ 
eer Oe es PP oe rE 
Ci Pat te i Ane Ny nea tcGs ee DS ae ah a. wih ae Fe sh st tunlatcca se tieare Pen AAG See eatend amet na dae aanoriedlets - ss chendiesieenacnesuaeseate . bot arasntd sack 
Bea ccc tte eeee este tetneeeeenetneteeneenetneeneeneenesnecnesteceeessseesieeneeeeeeaeeeeseseesneretessenecseetessrenessssessesmtsnesneenseareeseeeys 
si tca did Pe tly a0 oe OOM O8 7. oS 35 cance seed dO eed ODE. fa) UW het Oe Oe hes fleet Sap Ute eae tar ah idea Rati tik tag As pei tee heli aad duane iat ae anid cna Shee ea Sh 
031.050 301 511X FOF Bee pe fe ee eG PATON OE ee gg Pe Catena hy OE Ae a nel te Va ape fy PS Oa We ye 
picket es eee OR Oreo i en cota cee otic sla ea costedemat vies tie Eieaminbig dl sec duateut ath aulea shuns Saltnd Soni toda soca aeeattle tae ac dalbe cata tease esd iarane aera ued eiclita eareor etere pesca utente aba 
031.052 341 513X FOP H 
be teat ae Selgin a tasieues OS EOF Ee cA ad oy BG te Re ay ne Pe ces feet lets NG gel ls at a Lig a i al tel A th Eula ceal, ety elena s hea ne ates ol nll na welgaaeld ne se 
Selick tee ete SNecce edatt ier uabd aus pallet aguitewetteamen te S16X **0  SSAVALL - SAVE ALL REGISTERS GN STACK ccc ccc ceccvencenucueceeuaneeeeeeeeeeceteveteneunasenteeeteees 
517X x 
SESE Aerie oe el ahcae ee aeigeda S18X * 0000 SSAYALL SAVES ALL THE REGISTERS ON THE STACK ccc cccc cece cccccecccevecencunseceeeneeeeeeeenene. 
51i9X x 
Re hinteb Goh tdiens Bones Coa hone aust odes ete ng 5 Ne Ua ot aN ba Ea a ee Ut Diath a NE rad alae a Le ek A 6 ir SN £6 ot Re LB tale ies Od Mie a hoe kee 
SOX x EXIT CSP SOR Fi nee a es A reine eng Sim eem CHa OLI ANSE SOS ae ye pN ee ead a, 
ne Ren nee te eee ee rey eee Te 50), Sn ee ET RE RM) ite 2) Sie 2 NOE ER a See ev ECR NCD ROR OR Ue nD en eee ROR A Om oD A ere TE RES nea OE mT 
2 3X XK (SF44) = TIE 
Sie Rhea tegen ee ele beanie WIS Pade ena eae LIE 0S, Scie ee MERRIE kl | OO a te OME cee RAC ET Been RET SOLO EN EE ORE AT OOM Te PNR OE 
525xX x USES tek 
Ad eee otro ete BS ae Ares ela aa eee eae Pa OD Re cl at eM Rk ate, see Nase Aik ate as Raat Boma elke Jatt eR A PER ei Dales Ate DL Aad hee Ne te hie te Ta nth ta ee 
BO?X 
airanettetacs okteaes 031.054... 343.....0........... 928X  SSAYVALL XTHE we... PUSH. He CHL = RETURN ADDRESS cece cc cncccceeccccecceancceceveccenecs 
631.055 325 529X FUSH ll 
cop Ramet IN i NO ld oD oo 2 nt OR cok a Hie aaa NN ea tee Hes al NaS ak 2h ts on te te a Sich aca Daten ls inate hee al th eat ila alas, | at re San atte Zou 
031.057 345 531X FUSH FSW 
a Suniel aaenet pe B51 ae 2 UR a 10 er gl | oO =| Le | Se eR ES a SR ge I eR 
S35X «x $TJNF ~ TABLE JUMF, 
OE LA NRE ne Cie en eT Te ae iiCTc SOS Rea OP ACT CORI LOAN tC ETDS ta er te PONT er POSEN Aes, Pt Ne De ROR OCA ise aren oe eT OS Rs eT ATOR Re een Pat Reamer AOR 
537X x USAGE 
thew Recut erecta: cause ab etah haan. Meseecsetin Mane tnoaeetane BAO FR cericd fcscecinn ada cs Ca watts tees tam ult Sere wna aud planta Caease ue pet at alaly Ce taste NS Nat aan eral alan Pat hata A os ial a ae a Nal a Da etl cones 
539K t CALL $T IME (A) = INDEX 
See ht Oto eae tata Pity cee, Bits tebe hua Malthe ae DAOK ER 2 oe NW ck oo CONER Eo ee tee eo PINT EK Oe te is ee oh Ta ate atten a Se 3 alt le io ae lh Saves, ee A A ee he Bite he sl pu eee 
S41X x ry e 
alee de ce Beas Sycleodte Dethea se aaa eae Beton atuee es Bree eres earn Ok Sake Tbe I aA A recs wine Ti ce tak es EP ER et Oe 
SAX * o * 
Fite Ne AAG fe tice eA hc Mince diese Oityat, Ae dekh ee U1 Gat, See nny © | SORRY = 7) 151 \ 1] Ceara | ccs ne ae Ome FS DO PO RO TT 
545X x 
Pir ptsae te Giged woaaieuiladen so sceea aetna odes ee tcf: Xie, Sea eeepc 5 COIL = 9 Ore 1) 20, Gen ge EO eT REE eR I UIE Ce DP Pa a OE 
SA7X * EXIT TO PROCESSOR 
waeicasnsat uidiasare totiadiacon angie a ede eae lbear eh ce Manatek cers PAS KR Sect Bn a Notte ue CEN ee NIUE Mek sash ition od, cinta sh vt vin di afectast Abu siasate avlvi-cia oencuaie Sis to a PSOaNG S/o deve a WN ELT a ree wT orl a Mans bas aad enoaitiaveag sen: 
SAGX x USES Ark 
Fekete Otto Ee alae eee tee, ales aes toad baka: SI OP NIE ot Re cet eee Sete bale fe ela ata Ms A NS ae Nag chs otis tone eh oat oe a id ae etal ota vey nee tee coterie eso Wes 
551X 
san hee ete LOC TY 9 =)" Seo SS a ae Tn ROR” 07 Gee: At Rg. Or ee a STS = eee ©» || 0. 2. Oa Oe Oe er DL 
553X 
Sat stared <iteuanetes® 097 (066 ce rk OAM AST IMB SEQ mM eee bce ee ad Sate eee lies Succeed ow ablh Bogan yesus bomobabve an bea eesdeemulen saw hoe ddeasu set hoon een alabama needs 
031.062 343 555X XTHL (HL) = TARLE ADDRESS 
een rere, 0342063. ..365 0 000........... OX... PUSH SW SAME, INDIE? occ ccc cc cnc n ccc cececncececeucececucecucuccvccccccecetetvcsctseetetevace 


031.064 315 101 030 wo7X CALL SDALA. 
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Hi7ROM - Hi? 
COMMON LECKS 


O81 .047 “iF 
031.070 043 
631.071 "148 


031.073 381 
031.074 3423 
031.075 341075 


Pete het de Neos PS ORT VOTE 
031.076 343 
O31,077 735 
031.100 137 
031.101 026 000 
031.103 O31 

Saliaten ROE Sea OST 164 LTS 
031.105 O31 
031.104 321 
031.107 343 
031.1f0 311 


eee amen cease 


Ce oe 


NG. HEATH HSASM V1.4 01/20/78 FAGE 12 
Sata de GIN EC NS oo sae lb Sancho once widigioe sd ae dee tea Teed gids Sees ad Mow ete ees ee SBT AE cnceees otek: ADS: SAT AO LEAMA RLS, oso ok Sess Pe hese hha cated Cae i ahadeew eno bs 
etc at ater lesusraeal westeden Daao Me nes, ane oth RE pS aE OR pee 
OLD OR Be oad Seiduas TR deen aN Re hs Uae de ote nite cs os TN ale res een et ial Sane OP a aM te IRA ah cel is Sal Ritaacclartae gabon Win, cos. ak et ecg tec aitoataete 
Psitia old fon ere ee anes ae 
; 0978 DOF ccc OAK. eee. HOV! Fe ty cacos suite pang ete easel aaa aan ar a ache lathicaratait aa eisai aerate eater Sania Lastest hee lentnaets Deke ret ot meat ea esivae thee ade 
TES 62x FOF FSW (A) = INDEX*2 
fee ccueceuloaas od 4) ee eee eee ene PDE SSIES AMOI a8 2 2s tia pd seats eae Soda tegntou Ncw ae Vata Oa Oeae Rp geeegaoneUeU outta tan 
Fie Saha tees Oe WINE Oe gst ee eed G8 a ares pa OND RE PRORE Reo 
900% AE oe eRe =, BRANCH RELATIVE THOUGH, PARLE 60 cxct couse ae caeiindegatistagiee ce Senaaed Bie na leuuuSleanconsnudscueenad nme 
548x ¥ 
SOPX X . REBRA USES THE SUPPLIED INNEX TO SELECT A BYTE FROM THe ooo. cccccccccce cecceeccucccececsercecceseneeas 
STORE JUMP TARLE. THE CONTENTS OF THIS BYTE ARE ALLEL TO THE 
Bona getters GREE COR OE TE MU TEr, TEAR BIENG. THEE ROCESSOn COMBE a: Ek Aa ag eedahee AC oewa Rede Me als Sha eat can ato bac chica, 
re eon * 
utenti Leet Nc cc ERE Na ea 8 get a wtb eat od a a aaa anes ined wesc AG bhai us wed reec ot nine b ibis a ER Takai th ed abode ndtien nienctone 
tbe radel ade maccicetes ca tHe anion See Steele 2 roe $ ee eee eee ee 
7X Ok Dk Be Pare tt lag pee Me Sa see ea Sete tte wag Ue aaa ran u-nfuetoarawudied pat ve luck iad ae oe ale Mad adpenate 
SASK RO ee LARN~* ““INUEX = N-1 FOR LAEN 
u77X x a ee OS 
ESE EU UERRRW CURA CE UERTIERT 
D7. ors csuadpalgnciateee oe: 05) 2 JenoIEL |) OS, LO ee EOE oo jadlea tds ntanaee 
SSO EXYT TO COMFUTED ADDRESS 
SBIX * WS chau PEL os beck cepa res ag ennecuree Sea NS pss adud pale aae imines ute Dubdoutnanid sansa end iaaaedgeicaeudnsouekeuaetuosed 
Re eee Cee RENEE IN ee E tne a Tw bagi 
383X eee ee sess ec esos eres ee seeeeases esses eseeeere nese eeses eee eeeee sr eee eee re eet eee EE est eeneas ee EE ESE EEE BDO EEE DOSE HME er Date Ha wees eesseeeeesteneesnseeen 
Bestel hacen tects Gere oats oe de Sea ETHER CEL ¥ 
u85X POEM as fs os ce actlre Cantona incase he emg UB MARE SG ado tine Sua aie oh sets bese eins Sdoe te addedoe dudihinneddestiiee 
eT PN rc cds Os kk Seay UU BYU 
387% LE nE2a SOMELES Se BaD SORRENTO Tea NSIT GRO NED INGE SE URC Ce ROT A SU ORT a Na TE We eI at oe nT 
we hued sh aee OS Ce cant tt Cteue teh wat peas BHGY UU MOE UU Beg , 
SOPX AD. IN ices Sand Beh ee oo Ps SH oP ARURESS OF ER EMEIG oooh ou ah eta aaee ube deuede is alan seamen uaWeeles oer eeeensee 
Ue sede a dy ale Ege ago ar 
foie Sede Vasu Dineen DAD. Ll cs Gadesued caeianses ee eet ROC HOSUR AUURESS © 5. 250s 2acindbieasacwleustieoedewws als avewe etn bakankeeloeasslakets 
cece cece GSE 108 OSE, ere ate i 
are er aaa ge ed ec a ath ge ta Seats Bate tate Aactlh a ee na ensie cite tnt aa he Utah I at hele 2 ast Meas Calc Tid eh ate Nereis teal Tee 
seule vane de At AO BAO 8 el oe aoe ae 
Se Sa TE Te TE TL Mie iret OF URE: EM cate ly teh eet Eh ICC vets Son tes eared Suntech pad weet re wha ta et ea nha sit tees Eve Aloette NS et aid ol a 
is Csetemetocs pa Ree 
I ae ha tat Eg ig bal aoe Ri aisle where ash on parle oie Atel cies eh alin Rie erate Sada as ee ocala a ae oes Glas | 
500X *¥ 
BOE ed ocak ncs ches IS WERE ic, 2 cat cat hatd aed ehaaaia al nathe bieammuersalsincoh ie tend sacasle nani valeu a dhaaelae kare ara esa occa atieloaewe Menmetse att 
602X'* ‘i : 
sada cab tnaeene meas LL Re AM a, SE Oe OA SOR EIEE RTP Pee am HIT eS LETTE Pea) eae RATES Ee ROY TDR UP eee OTT RT ER ENT TW MUR MEE SENT gre nt Tee a Roe We nae 
ci Somerdale ces decaG hes Pepi age etree ees oOax a sever yar 
pageicaae Oe iii OE Ba Sth a lod Gz Secret Rg tains Se Harp cath dtu ass aa Mal eateglnaaestw a x Sous Biace ik Gide pga aad Titre Sal ENGR A a No RAD OS ico 
RA SPE NT pt nae eens 
607X xX ENTRY... (A) = PATTERN 


Ce i a ee et ee ee i ee a i ee ee ee 2] 
em eee meen weer rw w rete s em ee ees n nea sesersenesensensoreeeesee 


Cem e meee me meee mame eee R HEHE RHO RHEE HEHEHE EERE ERE R REO E EEE HEE EEE EEE REESE OHHH HEHE EES SHEER H HERES E EEE EES EH EEE ERE E OSES HEHEHE EERE E TEES OHS EERE HERETO TEE EEE EEO ATE ESS EEE OSE EERE EeEeTEREHE EEE ES 


ee i ee ee Oe i ee ee a ee 2 ae ae ee a ae oo ey 


aia acai H17ROM - H17 ROM COLE LISTING. HEATH H8ASHM V1.4 01/20/78 FAGE 13 
Sia eens POTION, PE CI ec 2 ices wastes casa Yeriare pine wepedeehoenioctate a a esha Seid Qa ara cave Haley Bias Wide kia x ig Ne PS arc ce been a A Oe cg A ON Fn os cca nisin cote aii iced bio uae Ra aishwSiia 
Siete cated taecsteesi ae Pane eateries tee te ctsiea nts DT ae REL OPES en REESE SESES SSE SESE OSES SEOEOSOSSESOOSSOEISOSSSOEEEOSSSSSOSOOOEOSOOSSOSE 
aera at GM Aa ts weer a leo atest, Svan, Santee Atak 609X Ko EXIT CRD, SR GL TERN SE SPOUND, 3 tit Ps ade itl adits do atid (one hea Gas dveesial AAG ROME ROR ase 
vite esate tasee pecans ict ne aera CAA 
611X xX USES Ne that to has 8 ee tig otc fe Ra ARG al peter ibe nace eee Gaiet Mataatelel deh te dM teed est enue dbedut inet ae k ee 
Re ATRIN oer te tee MAT CRT Oe oe AR eT 507 Eis SESE EES 
Soest dad tok tthe ocenele medeat Sicldstet cates EK le ida Sales ctete hdc teres che hc tee crac ainca gles Ue Ri wa amen Med tt aed ee eater f Orin kad ata eal hd el aa gti, ce egy Ee oe 
031.111 305 614X $TRLS FUSH k 
ick Rig isda: OR 8 OT A read ae Ot Oia te 2 sh 8k LOW we Sere BB oP CG tet Nd No nas ates es Le Rte io dle oleh ate Ao dine Meee aa ee es eine re deste hyo. 
031.113 1764 516X $TBLi MOV Arh (Ad = CHARACTER 
igivaeeusnu ses OR Dee eter as tele eUOE eM 32 4S a aad UE nt Ate PE en The Sta Oh S LAA S aire te Shahn cue canst Cena euace ta wa siees Ae aeleed diiavoaul nual Siete wut 4a Sonos Gaede oe teeta buena Se 
031.115 312 133 031 618X JZ TEL? IF MATC 
Sidi aeeemaes OE Be ane a ene tue fied Pats uca adlteu ee eae EM ihe ae Peet UC ta Mah gney We hire ton Dn gu Ad Naa ba aul SooRiGee Mastews valued Geedad eed sen seals kiwsiat oad nemiunteloa ead et toasted. 
O2Z1,121 043 620% INX H . 
pr As eck OB Ue SOAS 85 oh oe nse Oe Rie Colne a Nee on lee ee ot we a IONE RNG 2 Deh tts Boat le ue tag os al oo el te dail eel Dee Atel Gates reales 
031.123 302 112 O31 622X JINZ $TRL1 IF NOT ENT! OF TABLE 
So ett atecn ts | DOB OI a it hati tO a op ya Nae ital a la den hescBe a ints ib Datel sda ee dead ore igre iW ios ees ca eee St A GG tn Bd aged oc ea aes eat 
O31.,127 O83 6&24X rrcx H 
Pee eae rene Oe FMS O OOM oy os Sen on OM lanes ante alNiacuase lle adateanatalflae aan ie DAEMON 200 os dak utabaccetdinss Macha deanwhs aba diaein ie cian coe ne Cede aa ten wales cehetawites 
031.131 O78 9009 626X MVI AsO SET (A) = O FOR OLE USERS 
ie 627% eee eters eee terete eevee eerste esreesesresesestuseeeeeereeeose ee eeeteeeereeresesese eee eeeeeeee eee eee eseeereeeeoeneeneeeeeenene 
teeeeeceecnereretencneesere centeatetncneetss GEEK a eeeeeeeees apne 
a sult da Mr dihideate bas See ptea wetis hadi bitan set been ince ert ene Diced h tinh bate nk wire ee ee Oineim eet ee inte case stems Le etauel ts ie ha nh aN COS oi cat ace la Bee ste ele Ne cea baat Oe N AG re poe ones 
031.133 301 430X $TBL2 FOF 5 
Steg he thcetcn as OSE EBA OS) ot ee oh ee ad ts otek Se te ttl Ay GS LO Jee Se a an Le IIR Va rd ol nt was ul one ee cae £ Oath Air bah ada e ada el tak oo aa ate ME ieee eG we hice tae bet Scdaie a) 
031.135 311 &52X RET 
Bea iaen ondeate ne felon aaa sare em aaa PORaG Ee ote tenes BEG Ke cut RVD Pee PVE LG KU tccicnce oad cera sata itusta ees bbe teen g Riceia t calerteeds Sesdte a ted a Wis Ae SO eae ese desk in i Mea cna 
S38X% X 
wakes aah bat eects ate ats k i shoo a8 $637X K........, STYPTX, 1S CALLED TO, TYPE. A, BLOCK OF, TEXT..ON, THE. SYSTEM CONSOLE. ooo... coc cccccccccccecccecuccuceenceeens 
S$38X X 
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